Sintaxis de consulta

Documentos > APM > Trace Explorer > Sintaxis de consulta

Esta traducción no está actualizada. Para consultar la última versión en inglés, haz clic aquí

Consulta de búsqueda

Todos los parámetros de búsqueda están contenidos en la URL de la página, lo que puede ser útil para compartir tu visualización.

Sintaxis de búsqueda

Una consulta se compone de términos y operadores.

Hay dos tipos de términos:

Atributo de tramo: Contenido del tramo, recopilado con instrumentación automática o manual en la aplicación.
Etiqueta de tramo: Enriquecimientos de contexto relacionados con el tramo. Por ejemplo, etiquetas de servidor o contenedor que describen la infraestructura en la que se ejecuta el servicio.

Para combinar múltiples términos en una consulta compleja, utiliza cualquiera de los siguientes operadores booleanos:

Operador	Descripción	Ejemplo
`AND`	Intersección: ambos términos están en los eventos seleccionados (si no se agrega nada, se toma AND por defecto)	autenticación Y fallo
`OR`	Unión: cualquiera de los términos está contenido en los eventos seleccionados	autenticación O contraseña
`-`	Exclusión: el siguiente término NO está en el evento	autenticación Y -contraseña

Búsqueda de atributos

Para buscar un atributo de tramo, debes agregar @ al principio de la clave del atributo.

Por ejemplo, si deseas acceder a un tramo con el siguiente atributo a continuación, puedes usar:

@git.commit.sha:12345

  "git": {
    "commit": {
      "sha": "12345"
    },
    "repository": {
      "id": "github.com/datadog/datadog"
    }
  }

Los atributos de tramo son visibles en la pestaña Resumen del panel lateral de trazas.

Nota: No necesitas usar @ en los atributos reservados: env, operation_name, resource_name, service, status, span_id, timestamp, trace_id, type, link

Búsqueda de etiquetas

Tus tramos heredan etiquetas de los servidores y las integraciones que los generan.

Por ejemplo:

Consulta	Coincidencia
`(hostname:web-server OR env:prod)`	Todas las trazas con la etiqueta de infraestructura `hostname:web-server` o el atributo reservado `env:prod`
`(availability-zone:us-east OR container_name:api-frontend)`	Todas las trazas con cualquiera de estas etiquetas de infraestructura
`(service:api AND -kube_deployment:canary)`	Todas las trazas del `api` servicio que no están desplegadas en el `canary` despliegue

Las etiquetas de tramo son visibles en la pestaña Infrastructure del panel lateral de trazas.

Formatos de etiqueta no estándar

Si tus etiquetas no siguen las mejores prácticas de etiquetas, entonces no uses key:value sintaxis. En su lugar, usa la siguiente consulta de búsqueda:

tags:<MY_TAG>

Por ejemplo, esta etiqueta no sigue las mejores prácticas:
auto-discovery.cluster-autoscaler.k8s.io/daffy

Para buscar esta etiqueta, utiliza la siguiente consulta:
tags:"auto-discovery.cluster-autoscaler.k8s.io/daffy"

Comodines

Para realizar una búsqueda con comodines de múltiples caracteres, utiliza el símbolo * de la siguiente manera:

service:web* coincide con cada traza que tiene un servicio que comienza con web
@url:data* coincide con cada traza que tiene un url que comienza con data.

Valores numéricos

Utiliza <, >, <= o >= para realizar una búsqueda en atributos numéricos. Por ejemplo, recupera todas las trazas que tienen un tiempo de respuesta superior a 100 ms con:

@http.response_time:>100

También es posible buscar atributos numéricos dentro de un rango específico. Por ejemplo, recupera todos tus errores 4xx con:

@http.status_code:[400 TO 499]

Autocompletar

Escribir una consulta compleja puede ser engorroso. Utiliza la función de autocompletar de la barra de búsqueda para completar tu consulta utilizando valores existentes:

Escape de caracteres especiales

Los siguientes atributos se consideran especiales: ?, >, <, :, =, ", ~, / y \ requieren ser escapados. Por ejemplo, para buscar trazas que contengan user=JaneDoe en su url, se debe ingresar la siguiente búsqueda:

@url:*user\=JaneDoe*

La misma lógica debe aplicarse a los espacios dentro de los atributos de traza. No se recomienda tener espacios en los atributos de traza, pero en tales casos, los espacios requieren ser escapados. Si un atributo se llama user.first name, realice una búsqueda en este atributo escapando el espacio:

@user.first\ name:myvalue

Búsquedas guardadas

No pierda tiempo construyendo las mismas visualizaciones todos los días. Las búsquedas guardadas contienen su consulta de búsqueda, columnas y horizonte temporal. Luego están disponibles en la barra de búsqueda gracias a la coincidencia de autocompletado, ya sea por el nombre de búsqueda o la consulta.

Para eliminar una búsqueda guardada, haga clic en el ícono de papelera en el menú desplegable de búsqueda de trazas.

Buscar servicios y entidades

Rango de tiempo

El rango de tiempo permite mostrar trazas dentro de un período de tiempo determinado. Cambia rápidamente el rango de tiempo seleccionando un rango preestablecido del menú desplegable (o ingresando un intervalo de tiempo personalizado):

Tabla de tramos

La tabla de tramos es la lista de tramos que coinciden con el contexto seleccionado. Un contexto se define por un filtro de barra de búsqueda y un rango de tiempo.

Mostrando una traza completa

Haga clic en cualquier tramo para ver detalles sobre la traza asociada:

Columnas

Para agregar otras etiquetas de tramo o atributos como columnas a la lista, haga clic en el botón Opciones y seleccione cualquier dimensión que desee agregar:

Grupos de trazas

Agrupe la consulta por cualquier etiqueta de tramo o atributo para observar los conteos de solicitudes, tasas de error y distribuciones de latencia en la visualización de lista. Puede seleccionar hasta cuatro dimensiones en la cláusula Agrupar por.

Consultas ‘Agrupar por’ avanzadas

Después de seleccionar una dimensión para agrupar, puede especificar de dónde obtener los valores de la dimensión utilizando el menú desplegable de:

Tramo: Agrupar por la dimensión del tramo consultado (predeterminado). Por ejemplo, a.
Padre del tramo: Agrupar por la dimensión especificada del tramo padre de los tramos que coinciden con la consulta. Por ejemplo, para visualizar cómo se desempeña un punto de conexión de API según el servicio que lo llama, agrupar por service de parent(a).
Tramo raíz: Agrupar por la dimensión especificada del tramo raíz de la traza. Por ejemplo, para analizar patrones de solicitudes del backend basados en las páginas del frontend de donde provienen las solicitudes, agrupar por @view.name de root.

Ver grupos de trazas en la lista de grupos

Los grupos de trazas se muestran como valores únicos de la dimensión seleccionada. Cada grupo se muestra con tres métricas clave:

SOLICITUDES: Conteo de tramos dentro del grupo.
ERRORES: Tasa de error y conteo de errores.
Latencia P95: latencia p95 de los tramos.

Para ver estas métricas agregadas sobre el tramo padre o raíz en lugar del tramo consultado, seleccione parent(a) o root en la declaración Mostrar métricas de.

Además, el Latency Breakdown muestra cómo se distribuye el tiempo entre diferentes servicios en las solicitudes de cada grupo, permitiéndote identificar visualmente los cuellos de botella de latencia para dichos grupos.

Para un análisis más profundo, haga clic en cualquier grupo para examinar los eventos de tramo individuales que componen las métricas agregadas.

Una faceta muestra todos los valores distintos de un atributo o una etiqueta, así como proporciona algunas analíticas básicas como la cantidad de trazas representadas. Esto también es un interruptor para filtrar sus datos.

Las facetas le permiten pivotar o filtrar sus conjuntos de datos basados en un atributo dado. Ejemplos de facetas pueden incluir usuarios, servicios, etc…

Medidas

Las medidas son el tipo específico de facetas para valores cuantitativos.

Utiliza medidas cuando necesites:

Agregar valores de múltiples trazas. Por ejemplo, crea una medida sobre el número de filas en Cassandra y visualiza el P95 o los referers principales por la suma del tamaño de archivo solicitado.
Calcular numéricamente los servicios con la mayor latencia para valores de carrito de compras superiores a $1000.
Filtrar valores continuos. Por ejemplo, el tamaño en bytes de cada fragmento de carga de un flujo de video.

Tipos

Las medidas vienen con un valor entero (largo) o doble, para capacidades equivalentes.

Unidades

Las medidas soportan unidades (tiempo en segundos o tamaño en bytes) para el manejo de órdenes de magnitud en el tiempo de consulta y el tiempo de visualización. La unidad es una propiedad de la medida misma, no del campo. Por ejemplo, considera una medida de duración en nanosegundos: tienes una etiqueta de tramo de service:A donde duration:1000 representa 1000 milliseconds, y otras etiquetas de tramo de service:B donde duration:500 representa 500 microseconds: Escala la duración en nanosegundos para todas las etiquetas de tramo que fluyen con el procesador aritmético. Utiliza un multiplicador de *1000000 en las etiquetas de tramo de service:A, y un multiplicador de *1000 en las etiquetas de tramo de service:B. Utiliza duration:>20ms (consulta la sintaxis de búsqueda para referencia) para consultar de manera consistente las etiquetas de tramo de ambos servicios a la vez, y ver un resultado agregado de un máximo de un minuto.

Para comenzar a usar un atributo como una faceta o en la búsqueda, haz clic en él y agrégalo como una faceta:

Después de crear una nueva faceta, estará disponible en el panel de facetas para filtrado y análisis básico.

Utiliza las facetas para filtrar tus trazas. La barra de búsqueda y la URL reflejan automáticamente tus selecciones.

Visualizaciones

Selecciona un tipo de visualización analítica usando el selector analítico:

Series temporales
Lista principal
Tabla

Series temporales

Visualiza la evolución de la métrica Duration (o un conteo único de valores de una faceta) a lo largo de un período de tiempo seleccionado, y (opcionalmente) divide por una faceta disponible.

Las siguientes analíticas de series temporales muestran la evolución de la pc99 duración en intervalos de 5min para cada Servicio.

Lista principal

Visualiza los valores principales de una faceta de acuerdo a su Duration (o un conteo único de valores de una faceta).

Las siguientes analíticas de lista principal muestran la pc99 duración de Servicio:

Tabla

Visualiza los valores principales de una faceta de acuerdo a una medida elegida (la primera medida que elijas en la lista), y muestra el valor de medidas adicionales para los elementos que aparecen en esta lista principal. Actualiza la consulta de búsqueda o investiga los registros correspondientes a cualquiera de las dimensiones.

Cuando hay múltiples dimensiones, los valores principales se determinan de acuerdo con la primera dimensión, luego de acuerdo con la segunda dimensión dentro de los valores principales de la primera dimensión, y finalmente de acuerdo con la tercera dimensión dentro de los valores principales de la segunda dimensión.
Cuando hay múltiples medidas, la lista principal o inferior se determina de acuerdo con la primera medida.
El subtotal puede diferir de la suma real de los valores en un grupo, ya que solo se muestra un subconjunto (principal o inferior). Los eventos con un valor nulo o vacío para esta dimensión no se muestran como un subgrupo.

Nota: Una visualización de tabla para una sola medida y una sola dimensión es lo mismo que una lista principal, solo que con una visualización diferente.

El siguiente análisis de registros de tabla muestra la evolución de la lista principal de códigos de estado de acuerdo con su rendimiento, junto con el número de IPs de cliente únicas, y durante los últimos 15 minutos:

Selecciona o haz clic en una sección del gráfico para acercar el gráfico o ver la lista de trazas correspondientes a tu selección:

Exportar

Exporta tus consultas:

Para monitor
Para dashboard
Para notebook

También puedes generar una nueva métrica para la consulta.

Nota: Las consultas de APM en dashboards y notebooks se basan en todos los tramos indexados. Las consultas de APM en monitors se basan únicamente en tramos indexados por custom retention filters.