Docs » Connect to your cloud service provider » Connect AWS to Splunk Observability Cloud » GetMetricStatistics API deprecation notice

GetMetricStatistics API deprecation notice ๐Ÿ”—

Note

Splunk will remove support for the GetMetricStatistics API on May 1, 2023 May 23, 2023 May 31, 2023. After this date only the GetMetricData API will be used. Follow the instructions on this document to migrate to the GetMetricData API.

Splunk Observability Cloud provides a unified view into metrics, traces, and logs coming from various sources through integrations with third party services, including AWS integrations.

Splunk provides the following options to integrate with CloudWatch:

  • GetMetricStatistics, the legacy poll-based API.

  • GetMetricData, the modern poll-based API. It supports bulk retrieval of CloudWatch metric data. Shifting from GetMetricStatistics to GetMetricData can result in up to 20 times fewer API calls, substantially improving performance and data latency.

  • Metric Streams, the streaming API.

Switch to the GetMetricData API ๐Ÿ”—

You can configure any existing integration to use the GetMetricData API, all you need to do is to ensure Splunk Observability Cloud is allowed to use the GetMetricData API.

To do so, add "cloudwatch:GetMetricData" in the Action section of the AWS IAM policy JSON document.

Configure the API using the AWS UI ๐Ÿ”—

Alternatively, you can configure this using the AWS Management Console.

Select GetMetricData (and other permissions if pertinent), choose Review Policy, and then save the changes to make them effective.

Monitor the effects of the new configuration ๐Ÿ”—

Monitor CloudWatch integration calls by checking the sf.org.num.awsServiceCallCount metric. This metric tracks the number of calls by a method and aws_account_id so you can easily verify what API each AWS account is using.

After switching to GetMetricData, you should see:

  • A significant reduction (up to 20x) in the total number of calls required to obtain data.

  • A related reduction in the latency of data obtained by polling CloudWatch.

Manage costs ๐Ÿ”—

If an AWS account produces many CloudWatch metrics, the improved performance might lead to an increase in the AWS API cost.

For example, if the GetMetricStatistics API takes 5 minutes to retrieve all the data, the GetMetricData API might take only 1 minute. When an AWS integrationโ€™s poll rate is set to 1 minute, the GetMetricData requests are sent up to 5 times more often, generating a larger AWS API bill, while improving data latency at the same time. Increase the poll rate to 5 minutes to keep the cost at the same level.

You can keep track of the CloudWatch API cost incurred by Splunk Observability Cloud using the AWS CloudWatch integration pricing section in the Organization Metrics / Cloud Integrations built-in dashboards.