View a markdown version of this page

Activación de las métricas suministradas en PromQL - Amazon CloudWatch
Activación del enriquecimiento de OpenTelemetry para las métricas suministradas

Activación de las métricas suministradas en PromQL

sugerencia

Para obtener más información sobre OpenTelemetry en CloudWatch, consulte el taller y la serie de eventos de Cloud Operations Enablement.

Puede habilitar el enriquecimiento de OpenTelemetry para que las métricas suministradas de los recursos de AWS compatibles se puedan consultar mediante PromQL. Una vez habilitadas, las métricas que contienen una dimensión de identificador de recursos (por ejemplo, EC2 CPUUtilization con una dimensión InstanceId) se enriquecen con etiquetas de ARN y etiquetas de recursos y se pueden consultar mediante PromQL.

La métrica enriquecida conserva el nombre de la métrica original y las dimensiones de CloudWatch, y agrega lo siguiente

  • Atributos del recurso: el ARN del recurso (cloud.resource_id), el proveedor de servicios en la nube, la región y el ID de la cuenta.

  • Alcance de la instrumentación: identifica el servicio de origen y marca la métrica como enriquecida con OpenTelemetry.

  • Etiquetas de recursos: cualquier etiqueta de recurso de AWS asociada al recurso, que se puede consultar como etiquetas de PromQL.

La métrica clásica original de CloudWatch no se modifica y permanece disponible a través de las API de CloudWatch existentes.

Activación del enriquecimiento de OpenTelemetry para las métricas suministradas

Antes de iniciar el enriquecimiento de OpenTelemetry, debe habilitar las etiquetas de recursos en la telemetría de su cuenta.

Puede habilitar el enriquecimiento de OTel para la cuenta en una región específica mediante la consola de CloudWatch, AWS CLI, CloudFormation, Terraform o el SDK de AWS.

En concreto, necesita permisos para la siguiente operación: cloudwatch:StartOTelEnrichment

Para habilitar el enriquecimiento de OpenTelemetry para las métricas de AWS (consola de CloudWatch)

  1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

  2. En el panel de navegación, elija CloudWatch y, a continuación, Configuración.

  3. En el panel Habilitar el enriquecimiento de OpenTelemetry para las métricas de AWS, active la característica.

AWS CLI

aws cloudwatch start-otel-enrichment

CloudFormation

Resources:
  OTelEnrichment:
    Type: AWS::CloudWatch::OTelEnrichment

Terraform

nota

El recurso de Terraform aws_observabilityadmin_telemetry_enrichment requiere que primero se configure el recurso aws_cloudwatch_otel_enrichment.

resource "aws_observabilityadmin_telemetry_enrichment" "example" {
}

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

Para obtener más información, consulte aws_cloudwatch_otel_enrichment en el Registro de Terraform.

Para habilitarlo en varias regiones, cree el mismo recurso en cada pila regional o invoque la API en cada región de interés.

Una vez activado el enriquecimiento, puede empezar a consultar las métricas suministradas con PromQL. Consulte : Consulta de métricas suministradas por AWS con PromQL.