This guide focuses on the AWS SDK for PHP client for Amazon CloudWatch Logs. This guide assumes that you have already downloaded and installed the AWS SDK for PHP. See Installation for more information on getting started.
First you need to create a client object using one of the following techniques.
The easiest way to get up and running quickly is to use the
and provide your credential profile (via the
profile option), which identifies the set of credentials you want to
use from your
~/.aws/credentials file (see Using the AWS credentials file and credential profiles).
region parameter is required. You can find a list of available regions
using the Regions and Endpoints
use Aws\CloudWatchLogs\CloudWatchLogsClient; $client = CloudWatchLogsClient::factory(array( 'profile' => '<profile in your aws credentials file>', 'region' => '<region name>' ));
You can provide your credential profile like in the preceding example, specify your access keys directly (via
secret), or you can choose to omit any credential information if you are using AWS Identity and Access
Management (IAM) roles for EC2 instances
or credentials sourced from the
AWS_SECRET_ACCESS_KEY environment variables.
profile option and AWS credential file support is only available for version 2.6.1 of the SDK and higher.
We recommend that all users update their copies of the SDK to take advantage of this feature, which is a safer way
to specify credentials than explicitly providing
A more robust way to connect to Amazon CloudWatch Logs is through the service builder. This allows you to specify credentials and other configuration settings in a configuration file. These settings can then be shared across all clients so that you only have to specify your settings once.
use Aws\Common\Aws; // Create a service builder using a configuration file $aws = Aws::factory('/path/to/my_config.json'); // Get the client from the builder by namespace $client = $aws->get('CloudWatchLogs');
For more information about configuration files, see Configuring the SDK.
Please see the Amazon CloudWatch Logs Client API reference for a details about all of the available methods, including descriptions of the inputs and outputs.