Consultas PromQL

Al incorporar métricas de OpenTelemetry a CloudWatch mediante OpenTelemetry Protocol (OTLP), el modelo de datos OTLP jerárquico se aplana en etiquetas compatibles con PromQL. En esta sección se describe la estructura de las etiquetas, la sintaxis de PromQL para consultar estas etiquetas y la compatibilidad con UTF-8 en PromQL.

Cuando se utiliza PromQL en CloudWatch, la convención de prefijo @ distingue las etiquetas con ámbito de OTLP de las etiquetas estándar de Prometheus. Los campos dentro de cada ámbito utilizan un prefijo doble @ (por ejemplo, @resource.@schema_url), mientras que los atributos utilizan un prefijo de ámbito simple @, por ejemplo, @resource.service.name. Los atributos de puntos de datos también admiten acceso sin prefijo para mantener la compatibilidad con las consultas PromQL estándar; por ejemplo, {"http.server.active_requests"} y {"@datapoint.@name"="http.server.active_requests"} son equivalentes.

Las expresiones PromQL se escriben entre corchetes y especifican el nombre de la métrica y un conjunto opcional de comparadores de etiquetas. En el siguiente ejemplo, se seleccionan todas las series temporales de la métrica http.server.active_requests:

{"http.server.active_requests"}

En el siguiente ejemplo, se seleccionan todas las series temporales de la métrica http.server.active_requests en las que el atributo de recurso de OpenTelemetry service.name equivale a myservice:

{"http.server.active_requests", "@resource.service.name"="myservice"}

Puede combinar varios comparadores de etiquetas en una sola consulta. En el siguiente ejemplo, se seleccionan todas las series temporales de la métrica http.server.active_requests en las que el atributo de recurso de OpenTelemetry service.name equivale a myservice en todas las regiones de EE. UU.:

{"http.server.active_requests",
 "@resource.service.name"="myservice",
 "@aws.region"=~"us-.*"}

En el siguiente ejemplo, se muestra una consulta de rango. Calcula el valor promedio de todos los puntos de datos dentro de un rango de tiempo específico para cada serie temporal:

avg_over_time(
  {"http.server.active_requests",
   "@resource.service.name"="myservice"}[5m]
)

En la tabla siguiente se resumen las convenciones de prefijo de cada ámbito de OTLP:

Consulta de métricas suministradas por AWS con PromQL

Para poder consultar las métricas suministradas por AWS en PromQL, primero debe habilitar el enriquecimiento de OpenTelemetry de las métricas suministradas. Consulte : Activación de las métricas suministradas en PromQL.

Tras habilitar el enriquecimiento de OpenTelemetry, las métricas suministradas por AWS se pueden consultar mediante PromQL con etiquetas adicionales. El nombre de la métrica es el mismo que el nombre de la métrica de CloudWatch original, y las dimensiones de CloudWatch originales están disponibles como atributos de puntos de datos. Están disponibles las siguientes etiquetas (el siguiente ejemplo es para una instancia de EC2):

El siguiente ejemplo selecciona Invocations para una función de Lambda específica:

histogram_sum({Invocations, FunctionName="my-api-handler"})

El siguiente ejemplo selecciona Errors de Lambda para todas las funciones etiquetadas con un equipo específico:

histogram_sum(
  {Errors, "@instrumentation.@name"="cloudwatch.aws/lambda", "@aws.tag.Team"="backend"}
)

El siguiente ejemplo calcula la cantidad total de Invocations de Lambda agrupadas por equipo:

sum by ("@aws.tag.Team")(
    {Invocations, "@instrumentation.@name"="cloudwatch.aws/lambda"}
)

El siguiente ejemplo selecciona todas las series temporales de la métrica CPUUtilization de EC2. El uso de "@instrumentation.@name"="cloudwatch.aws/ec2" es para identificar de forma exclusiva la métrica CPUUtilization de EC2 y no de otros servicios de AWS, como Amazon Relational Database Service:

histogram_avg({CPUUtilization, "@instrumentation.@name"="cloudwatch.aws/ec2"})