View a markdown version of this page

Métricas fornecidas pela AWS no formato do OpenTelemetry - Amazon CloudWatch
Habilitação do enriquecimento do OpenTelemetry para métricas fornecidas

Métricas fornecidas pela AWS no formato do OpenTelemetry

dica

Para saber mais sobre o OpenTelemetry no CloudWatch, confira o workshop e a série de eventos Cloud Operations Enablement.

Você pode habilitar o enriquecimento dos dados do OTel para que as métricas fornecidas dos recursos compatíveis da AWS possam ser consultadas por meio do PromQL. Depois de habilitar o enriquecimento dos dados do OTel, as métricas que contêm uma dimensão de identificador de recurso (por exemplo, CPUUtilization do EC2 com uma dimensão InstanceId) são enriquecidas com o ARN do recurso e os rótulos de tags do recurso, ficando disponíveis para consulta com o PromQL.

A métrica enriquecida preserva o nome da métrica original e as dimensões do CloudWatch e adiciona:

  • Atributos do recurso: o ARN do recurso (cloud.resource_id), o provedor de nuvem, a região e o ID da conta.

  • Escopo da instrumentação: identifica o serviço de origem e marca a métrica como enriquecida pelo OTel.

  • Tags de recursos : quaisquer tags de recursos da AWS associadas ao recurso, consultáveis como rótulos do PromQL.

A métrica clássica original do CloudWatch não foi modificada e permanece disponível por meio das APIs existentes do CloudWatch.

Habilitação do enriquecimento do OpenTelemetry para métricas fornecidas

Antes de iniciar o enriquecimento do OTel, você deve habilitar as tags de recursos na telemetria da sua conta.

Você pode habilitar o enriquecimento do OTel para sua conta em uma região específica usando o console do CloudWatch, a AWS CLI, o CloudFormation, o Terraform, ou o SDK da AWS.

Você precisará de permissões para a seguinte operação: cloudwatch:StartOTelEnrichment

Para habilitar o enriquecimento do OTel para métricas da AWS (console do CloudWatch)

  1. Abra o console do CloudWatch, em https://console.aws.amazon.com/cloudwatch/.

  2. No painel de navegação, escolha CloudWatch e depois Configurações.

  3. No painel Habilitar o enriquecimento do OTel para métricas da AWS, ative o recurso.

AWS CLI

aws cloudwatch start-otel-enrichment

CloudFormation

nota

O recurso AWS::CloudWatch::OTelEnrichment exige que o recurso AWS::ObservabilityAdmin::TelemetryEnrichment seja configurado primeiro. Para mais informações, consulte Habilitar tags de recursos na telemetria.

Resources:
  TelemetryEnrichmentExample:
    Type: AWS::ObservabilityAdmin::TelemetryEnrichment
  OTelEnrichmentExample:
    Type: AWS::CloudWatch::OTelEnrichment
    DependsOn: TelemetryEnrichmentExample

Terraform

nota

O recurso aws_cloudwatch_otel_enrichment do Terraform exige que o recurso aws_observabilityadmin_telemetry_enrichment seja configurado primeiro.

resource "aws_observabilityadmin_telemetry_enrichment" "example" {
}

resource "aws_cloudwatch_otel_enrichment" "example" {
  depends_on = [aws_observabilityadmin_telemetry_enrichment.example]
}

Para saber mais, consulte aws_cloudwatch_otel_enrichment no Terraform Registry.

Para habilitação em várias regiões, crie o mesmo recuso em cada pilha regional ou invoque a API em cada região de interesse.

Depois que o enriquecimento estiver habilitado, você poderá começar a consultar as métricas fornecidas por meio do PromQL. Consulte : Consulta a métricas fornecidas pela AWS com o PromQL.