Información general

Las facetas son atributos y etiquetas (tags) que el usuario define a partir de sus tests. Son útiles para el análisis de datos tanto cualitativos como cuantitativos. Las facetas permiten manipular los tests en los monitores de tests de CI y en las consultas de búsqueda que aparecen en dashboards y en notebooks.

Crear facetas no es obligatorio para buscar ejecuciones de tests. Las capacidades de autocompletar utilizan facetas existentes, pero también se aplica cualquier entrada que coincida con las ejecuciones de tests entrantes.

Facetas comunes

Ve a Software Delivery (Entrega de software) > Test Visibility (Visibilidad de tests) > Test Runs (Ejecuciones de tests) para acceder a la lista de facetas a la izquierda de la lista de ejecuciones de tests.

Puedes utilizar facetas en el Explorador de visibilidad de tests para hacer lo siguiente:

El Explorador de visibilidad de tests incluye las siguientes facetas:

FacetaDescripción
Proveedor de CIEl nombre del proveedor de CI (GitHub, GitLab, etc.).
Nombre del pipelineEl nombre del pipeline de CI.
Nombre del nodoEl nombre del nodo de CI que ejecutó el pipeline, la etapa o el trabajo.
Etiquetas del nodoLas etiquetas (labels) asociadas con el nodo de CI que ejecutó el pipeline, la etapa o el trabajo.
URL del pipelineLa URL del proveedor para la ejecución de un pipeline.
ID de pipelineEl ID del pipeline.
Número de pipelineEl número de ejecución de un pipeline de CI, que proporciona el proveedor de CI. Aumenta cuando se reintenta parcialmente un pipeline.
URL del trabajoLa URL del proveedor para la ejecución de un trabajo.
Nombre de la etapaEl nombre de la etapa de CI.
Nombre del trabajoEl nombre del trabajo de CI.
Espacio de nombres de KubernetesEl espacio de nombres en el que se ejecuta el pod de Kubernetes.
Nombre del pod de KubernetesEl nombre del pod de Kubernetes.
Etiqueta de la imagenLa etiqueta (tag) de la imagen de contenedor de Kubernetes.
Nombre del contenedorLa etiqueta del nombre del contenedor de Kubernetes.
Nombre de la imagenLa etiqueta del nombre de la imagen de contenedor de Kubernetes.
ID del contenedorEl ID del contenedor de Kubernetes.
Nombre del contenedor de KubernetesEl nombre del contenedor de Kubernetes.
Despliegue de KubernetesEl despliegue de Kubernetes al que pertenece un pod.
Conjunto de estados de KubernetesEl conjunto de estados de Kubernetes al que pertenece un pod.
URL del repositorioLa URL del repositorio de Git.
ID del repositorioEl ID que identifica de forma exclusiva un repositorio de Git.
SHA del commitEl SHA del commit de Git.
RamaLa rama de Git.
EtiquetaLa etiqueta de Git.
Correo electrónico del autorEl correo electrónico del autor de Git.
Correo electrónico del committerEl correo electrónico del committer de Git.
Fecha del committerLa fecha del committer de Git.
Fecha del autorLa fecha del autor de Git.
Variable de entornoEl entorno en el que se ejecuta el pipeline de CI.
RecursoEl recurso utilizado en el pipeline de CI.
Nombre de la operaciónLa operación realizada dentro del pipeline de CI.
Tipo de errorEl tipo de error encontrado durante la ejecución de CI.
TipoEl tipo de ejecución o entidad de CI.
Traza completaLa traza (trace) completa de la ejecución del pipeline de CI.
DuraciónLa duración de la ejecución en segundos.
VersiónLa versión del pipeline de CI o la herramienta utilizada.
Rama predeterminadaIndica si la ejecución se ha realizado en la rama predeterminada del repositorio de Git.

Facetas cualitativas

Utiliza facetas cualitativas cuando tengas que hacer lo siguiente:

  • Obtener una visión relativa de los valores.
  • Contar valores únicos.
  • Filtrar con frecuencia las ejecuciones de tests en función de valores particulares. Por ejemplo, crea una faceta sobre una etiqueta de entorno para seleccionar el contexto de solución de problemas como entornos de desarrollo, ensayo o producción.

Nota: Aunque las facetas no son obligatorias para filtrar las etiquetas, definir facetas para las etiquetas que utilizas con frecuencia durante las investigaciones te ayudará a agilizar de resolución.

Medidas cuantitativas

Utiliza medidas cuantitativas cuando tengas que hacer lo siguiente:

  • Agregar los valores de varios tests.
  • Filtrar el alcance de tus tests.
  • Clasificar tus ejecuciones de tests en función de ese valor.

Tipos

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

Unidades

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

Por ejemplo, considera una medida de duration en nanosegundos. Supongamos que las ejecuciones de tests de service:A tienen duration:10000000, lo que significa 10 milliseconds. Supongamos que las ejecuciones de tests de service:B tienen duration:5000000, lo que significa 5 milliseconds. Utiliza duration:>2ms para consultar de forma coherente las etiquetas de ejecución de tests desde ambos servicios a la vez. Para obtener más información sobre las consultas de búsqueda, consulta Sintaxis de búsqueda.

Panel de facetas

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

La barra de búsqueda y la URL reflejan automáticamente las opciones seleccionadas del panel de facetas.

  • Las facetas (cualitativas) incluyen un lista superior de valores únicos y un recuento de tests que coinciden con cada uno de ellos.
  • Las medidas (cuantitativas) incluyen un regulador que indica los valores mínimo y máximo. Utiliza este regulador o indica valores numéricos para seleccionar diferentes límites del contexto de la consulta de búsqueda.

Agrupar facetas

Las facetas se agrupan por temas significativos en la lista de facetas. Asignar o reasignar un grupo a una faceta solo afecta a la lista de facetas y no repercute en la búsqueda ni en los análisis.

Filtrar facetas

Utiliza el cuadro de búsqueda de facetas del panel de facetas para seleccionar el contexto de toda la lista de facetas y navegar hasta la faceta con la que necesitas interactuar. La búsqueda de facetas utiliza el nombre de visualización de las facetas y el nombre de los campos para seleccionar el contexto de los resultados.

Crear facetas

La creación de una faceta en un atributo o etiqueta de ejecución de tests no es un paso obligatorio para buscar ejecuciones de tests. Las facetas son útiles si desea añadir una descripción significativa a un atributo de ejecución de tests específico, o si desea que los valores del atributo aparezcan en la lista de facetas.

Crear facetas desde el panel lateral de Ejecuciones de tests

La forma más sencilla de crear una faceta es añadirla desde el panel lateral de Ejecuciones de tests, ya que la mayoría de los detalles de la faceta ya están rellenados.

Crear una faceta a partir de una ejecución de test fallida en el panel lateral de Ejecuciones de tests
  1. Navega hasta una ejecución de tests que te interese en el Explorador de visibilidad de tests que contenga el campo a partir del cual desees crear una faceta.

  2. Selecciona la ejecución de tests de la lista para abrir el panel lateral de Ejecuciones de tests.

  3. Haz clic en el campo deseado (en la sección Other tags [Otras etiquetas] de una ejecución de tests) y crea una faceta a partir de allí:

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

Crear facetas a partir de la lista de facetas

Si no es posible encontrar una ejecución de tests que contenga el campo deseado, crea una faceta directamente desde el panel de facetas haciendo clic en + Add (+ Añadir).

Añadir una faceta desde el panel lateral de facetas

Define el nombre del campo subyacente (clave) de esta faceta:

  • Utiliza el nombre de la clave de etiqueta para las etiquetas de infraestructura.
  • Utiliza la ruta de los atributos para los atributos de ejecución de tests, con el prefijo @.

La función de autocompletar basada en el contenido de las ejecuciones de tests de las vistas actuales te ayuda a definir un nombre de campo adecuado. Sin embargo, puedes utilizar prácticamente cualquier valor aquí, específicamente en el caso de que aún no tengas ejecuciones de tests coincidentes recibidas por Datadog.

Referencias adicionales