CloudWatch client

This page contains examples with the CloudWatch client. See the client introduction for a more detailed description how to use a client. You may also want to consider the authentication documentation to understand the many ways you can authenticate with AWS.

The CloudWatch package could be installed with Composer.

composer require async-aws/cloud-watch

A new client object may be instantiated by:

use AsyncAws\CloudWatch\CloudWatchClient;

$cloudWatch = new CloudWatchClient();

The authentication parameters is read from the environment by default. You can also specify a AWS access id and secret:

use AsyncAws\CloudWatch\CloudWatchClient;

$cloudWatch = new CloudWatchClient([
    'accessKeyId' => 'my_access_key',
    'accessKeySecret' => 'my_access_secret',
    'region' => 'eu-central-1',
]);

For all available options, see the configuration reference.

Usage¶

Get metric data¶

use AsyncAws\CloudWatch\CloudWatchClient;
use AsyncAws\CloudWatch\ValueObject\MetricDataQuery;
use DateTimeImmutable;

$cloudWatch = new CloudWatchClient();

$result = $cloudWatch->getMetricData(new GetMetricDataInput([
    'MetricDataQueries' => [new MetricDataQuery(['Id' => 'metric-id'])],
    'StartTime' => new DateTimeImmutable('2021-07-01T00:00:00'),
    'EndTime' => new DateTimeImmutable('2021-07-01T12:00:00'),
]));

foreach ($result->getMetricDataResults() as $metricData) {
    var_dump($metricData);
}

The source code to this page is found on GitHub.