Skip to content

[DOCS-13133] Expand AWS integration troubleshooting with high-frequency support topics#35349

Open
buraizu wants to merge 4 commits intomasterfrom
docs13133/consolidated-escalation-updates
Open

[DOCS-13133] Expand AWS integration troubleshooting with high-frequency support topics#35349
buraizu wants to merge 4 commits intomasterfrom
docs13133/consolidated-escalation-updates

Conversation

@buraizu
Copy link
Contributor

@buraizu buraizu commented Mar 17, 2026

What does this PR do? What is the motivation?

Expands the AWS integration troubleshooting page with new sections addressing the most common support ticket themes identified from analysis of 100+ escalated AWS integration tickets. Additions:

  • IAM propagation timing callout at the top of the IAM section
  • Missing metrics decision tree — 6-step diagnostic checklist
  • Expected metric delays table — comparison by collection method (API polling, Metric Streams, Agent) plus service-specific latency notes
  • Per-dimension metrics — explains inflated aggregation and _deduped variants
  • Region behavior — global vs regional services, opt-in regions, new region support
  • Tag collection and propagation delays — troubleshooting steps for missing tags

Merge instructions

Merge readiness:

  • Ready for merge

…cy support topics

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@buraizu buraizu requested a review from a team as a code owner March 17, 2026 18:40
@buraizu buraizu added the WORK IN PROGRESS No review needed, it's a wip ;) label Mar 17, 2026
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: be944f11c3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +62 to +64
Some AWS CloudWatch metrics are emitted once per dimension combination, which can produce values that appear inflated when aggregated in Datadog. For example, the `aws.elb.healthy_host_count` metric is reported separately for each Availability Zone and target group. Summing this metric across all dimensions results in a total that is higher than the actual number of healthy hosts, because hosts in multiple zones are counted multiple times.

To avoid this, use the `_deduped` metric variants when available (for example, `aws.elb.healthy_host_count_deduped`), or scope your query to a specific Availability Zone or target group.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove target-group guidance from ELB metric example

This new troubleshooting example mixes ELB concepts: aws.elb.healthy_host_count is the Classic ELB metric discussed later in this same page, and that section explains the overcount in terms of Availability Zones (not target groups). Telling users to scope by target group can send them looking for a dimension that does not exist for this metric, which makes the discrepancy workflow fail for the exact case this section is trying to fix.

Useful? React with 👍 / 👎.

@github-actions github-actions bot added the Guide Content impacting a guide label Mar 17, 2026
@github-actions
Copy link
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@buraizu
Copy link
Contributor Author

buraizu commented Mar 17, 2026

Applied — fixed per-dimension section to correctly describe aws.elb.healthy_host_count as a Classic ELB metric scoped by Availability Zone only, removed incorrect target group references, and added cross-reference to the existing detailed section in e5e38c2.

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e5e38c2314

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

4. **Check whether the service requires additional enablement.** Some AWS services do not emit metrics to CloudWatch by default. For example:
- Amazon RDS requires [Enhanced Monitoring][18] to be enabled in the RDS console for OS-level metrics.
- Amazon S3 Storage Lens metrics require Storage Lens to be configured in the S3 console.
- AWS billing metrics require [Cost Explorer][19] to be enabled in the AWS Billing console.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Replace Cost Explorer prerequisite for billing metrics

This troubleshooting step gives the wrong prerequisite for missing aws.billing.* metrics: enabling Cost Explorer is not what turns on CloudWatch billing metrics, and our own billing guide instead requires enabling billing metrics in AWS plus enabling Billing collection in the integration (content/en/integrations/guide/monitor-your-aws-billing-details.md, steps 1–2). Users following this checklist can remain blocked because Cost Explorer alone does not make aws.billing.estimated_charges appear.

Useful? React with 👍 / 👎.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@buraizu
Copy link
Contributor Author

buraizu commented Mar 17, 2026

Re: billing metrics prerequisite — Applied, replaced Cost Explorer reference with the actual billing prerequisites (enable Billing in Metric Collection tab, add budgets:ViewBudget permission, enable billing metrics in AWS console) and linked to the full billing guide in 47c55f0.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Guide Content impacting a guide WORK IN PROGRESS No review needed, it's a wip ;)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant