Descripción general

Las facetas son etiquetas y atributos definidos por el usuario de sus pipelines. Son útiles tanto para el análisis de datos cualitativos como cuantitativos. Las facetas le permiten manipular sus pipelines en sus monitores de pipeline de CI, y en consultas de búsqueda que aparecen en paneles y en cuadernos.

Crear facetas no es necesario para buscar ejecuciones de pipeline. Las capacidades de autocompletado usan facetas existentes, pero también se aplica cualquier entrada que coincida con las ejecuciones de pipeline entrantes.

Facetas comunes

Navegue a Software Delivery > CI Visibility > Ejecuciones para acceder a la lista de facetas a la izquierda de la lista de ejecuciones de pipeline.

El Explorador CI Visibility incluye las siguientes facetas listas para usar:

Puede usar facetas en el Explorador de CI Visibility para:

• Buscar y filtrar ejecuciones de pipeline
• Realice análisis de pipeline
• Comience la resolución de problemas una vez que sus pipelines se completen

Facetas cualitativas

Utilice facetas cualitativas cuando necesite:

• Obtenga información relativa para los valores.
• Cuente valores únicos.
• Filtrefrecuentemente sus ejecuciones de pipeline según valores particulares. Por ejemplo, cree una faceta en una etiqueta de entorno para contextualizar la resolución de problemas a entornos de desarrollo, staging o producción.
  

Nota: Aunque las facetas no son necesarias para filtrar por etiquetas, definir facetas para las etiquetas que usa a menudo durante las investigaciones puede ayudar a reducir su tiempo de resolución.

Medidas cuantitativas

Utilice medidas cuantitativas cuando necesite:

• Agregue valores de múltiples ejecuciones de pipeline.
• Filtre por rango sus ejecuciones de pipeline.
• Ordene sus ejecuciones de pipeline según ese valor.

Tipos

Las medidas tienen un valor de entero largo o doble para capacidades equivalentes.

Unidades

Las medidas admiten unidades (tiempo en segundos o tamaño en bytes) para el manejo de órdenes de magnitud al momento de la consulta y de la visualización. La unidad es una propiedad de la medida en sí, no del campo.

Por ejemplo, considere una duration medida en nanosegundos. Suponga que las ejecuciones de pipeline de service:A tienen duration:10000000, lo que significa 10 milliseconds. Suponga que las ejecuciones de pipeline de service:B tienen duration:5000000, lo que significa 5 milliseconds. Utilice duration:>2ms para consultar de manera consistente las etiquetas de ejecución de pipeline de ambos servicios a la vez. Para obtener más información sobre las consultas de búsqueda, consulte Sintaxis de búsqueda.

Panel de facetas

La barra de búsqueda proporciona el conjunto de interacciones más completo para filtrar y agrupar sus datos. Sin embargo, para muchos casos, el panel de facetas es una forma sencilla de navegar por sus datos. Abra una faceta para ver un resumen de su contenido para el contexto de la consulta actual.

La barra de búsqueda y la URL reflejan automáticamente sus selecciones del panel de facetas.

• Las facetas (cualitativas) vienen con una lista principal de valores únicos y un conteo de ejecuciones de pipeline que coinciden con cada uno de ellos.
• Las medidas (cuantitativas) vienen con un control deslizante que indica los valores mínimos y máximos. Utilice el control deslizante, o ingrese valores numéricos, para definir el contexto de la consulta de búsqueda en diferentes rangos.

Agrupación de facetas

Las facetas se agrupan en temas significativos en la lista de facetas. Asignar o reasignar un grupo para una faceta afecta solo a la lista de facetas y no tiene impacto en la búsqueda o el análisis.

Filtrado de facetas

Utilice el cuadro de búsqueda de facetas en el panel de facetas para definir el contexto de toda la lista de facetas y navegar hasta la faceta con la que necesita interactuar. La búsqueda de facetas utiliza el nombre de visualización de la faceta y el nombre del campo para definir el contexto de los resultados.

Creación de facetas

Crear una faceta en un atributo o etiqueta de ejecución de pipeline no es un paso obligatorio para buscar ejecuciones de pipeline. Las facetas son útiles si desea agregar una descripción significativa a un atributo de ejecución de pipeline específico, o si desea que los valores de los atributos aparezcan en la lista de Facetas.

Creación de facetas desde los paneles laterales de Ejecuciones de Pipeline

La forma más sencilla de crear una faceta es agregarla desde el panel lateral de Ejecuciones de Pipeline para que la mayoría de los detalles de la faceta estén prellenados.

1. Navegue a una ejecución de pipeline de interés en el CI Visibility Explorer que contenga el campo sobre el cual crear una faceta.

2. Abra el panel lateral de Ejecuciones de Pipeline seleccionando la ejecución de pipeline de la lista.

3. Haga clic en el campo deseado (en la pestaña Info para el tramo de una ejecución de pipeline) y cree una faceta desde allí:

   • Si el campo tiene un valor numérico, puede crear una faceta o una medida.
   • Si el campo tiene un valor de cadena, solo está disponible la creación de facetas.

Creación de facetas desde la lista de facetas

Si no es una opción encontrar una ejecución de pipeline que tenga el campo deseado, cree una faceta directamente desde el panel de facetas haciendo clic en + Add.

Defina el nombre del campo subyacente (clave) para esta faceta:

• Use el nombre de la clave de etiqueta para las etiquetas de infraestructura.
• Use la ruta del atributo para los atributos de ejecución de pipeline, con el prefijo @.

El autocompletado basado en el contenido de las ejecuciones de pipeline de las vistas actuales le ayuda a definir el nombre de campo adecuado. Pero puede usar prácticamente cualquier valor aquí, específicamente en el caso de que aún no tenga ejecuciones de pipeline coincidentes recibidas por Datadog.

Lecturas adicionales

Documentación, enlaces y artículos útiles adicionales:

Aprenda a buscar sus pipelinesDOCUMENTACIÓN Obtenga información sobre el CI Visibility ExplorerDOCUMENTACIÓN