Document AWS metric name filtering#38023
Conversation
Sergio-Na
changed the title
Sergio-Na
changed the title
Preview links (active after the
|
RaphaelAllier
left a comment
RaphaelAllier
left a comment
There was a problem hiding this comment.
Curious what the docs team has to say on wording too
|
|
||
| #### Required metrics | ||
|
|
||
| Metric name filters cannot remove `aws.ec2.cpuutilization` or `aws.lambda.invocations`. Datadog always collects these metrics because they are used for billing. |
There was a problem hiding this comment.
I would rephrase that but I don't know how. I'm not sure we should expose how billing is computed in our public docs
There was a problem hiding this comment.
I agree but Matt thought it would be a good idea. I was thinking something more along the lines of
Metric name filters cannot remove
aws.ec2.cpuutilizationoraws.lambda.invocations. Datadog always collects these foundational/critical metrics.
Something along these lines. I'll wait for the docs folks to chime in.
There was a problem hiding this comment.
I recommend removing the subheader and making this an alert. I added my suggestion below. If customers need to know about billing, we can add it back in.
estherk15
left a comment
estherk15
left a comment
There was a problem hiding this comment.
Left a few suggestion, let me know if you have any questions!
|
|
||
| ### Filter metrics by metric name | ||
|
|
||
| Use the {{< ui >}}Metric Collection{{< /ui >}} tab on the [AWS integration page][8] to filter the CloudWatch metrics that Datadog collects from each namespace. Expand a namespace in the CloudWatch metric collection table and choose an **Include** or **Exclude** filter: |
There was a problem hiding this comment.
| Use the {{< ui >}}Metric Collection{{< /ui >}} tab on the [AWS integration page][8] to filter the CloudWatch metrics that Datadog collects from each namespace. Expand a namespace in the CloudWatch metric collection table and choose an **Include** or **Exclude** filter: | |
| Use the {{< ui >}}Metric Collection{{< /ui >}} tab on the [AWS integration page][8] to filter CloudWatch metrics by namespace. Expand a namespace in the CloudWatch metric collection table and choose an **Include** or **Exclude** filter: |
|
|
||
| #### Required metrics | ||
|
|
||
| Metric name filters cannot remove `aws.ec2.cpuutilization` or `aws.lambda.invocations`. Datadog always collects these metrics because they are used for billing. |
There was a problem hiding this comment.
I recommend removing the subheader and making this an alert. I added my suggestion below. If customers need to know about billing, we can add it back in.
| [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html | ||
| [11]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html#turning_on_billing_metrics | ||
| [12]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-cloudwatch-new.html | ||
| [13]: /integrations/guide/monitor-your-aws-billing-details/ |
There was a problem hiding this comment.
| [13]: /integrations/guide/monitor-your-aws-billing-details/ | |
| [14]: /getting_started/integrations/aws/#filter-metrics-by-metric-name |
|
|
||
| Metric name filters support lowercase letters, numbers, `.`, `_`, and `*`. The AWS integration previews matching metrics before you save. Metric name filters apply per namespace; namespace filters still control whether the namespace itself is collected. | ||
|
|
||
| Metric name filters cannot remove `aws.ec2.cpuutilization` or `aws.lambda.invocations`. Datadog always collects these metrics because they are used for billing. |
There was a problem hiding this comment.
Recommend keeping this section brief and link out to the docs as the source of truth. It's less maintenance and lowers the risk of have diverging information.
| Metric name filters cannot remove `aws.ec2.cpuutilization` or `aws.lambda.invocations`. Datadog always collects these metrics because they are used for billing. | |
| Yes. On the [AWS integration page][1], open the **Metric Collection** tab, expand a CloudWatch namespace, and add metric name filters. Use **Include** to collect only matching Datadog metric names for that namespace, or **Exclude** to collect everything except matching metric names. | |
| For more information on syntax and required metrics, see [Getting Started with AWS][14]. |
Sergio-Na
force-pushed
the
sergio.najm/07-07-added_docs_for_aws_integration_metric_name_filtering
branch
from
3ea6e2e to
35ab495
Compare
3 participants
What does this PR do? What is the motivation?
Adds docs for AWS metric name filters in the setup page and FAQ.