Este producto no es compatible con el
sitio Datadog seleccionado. (
).
Descripción general
Los pipelines y procesadores descritos en esta documentación son específicos para entornos de registro locales. Para agregar, procesar y enrutar registros basados en la nube, consulte
Canalizaciones de Gestión de Registros.
En los Pipelines de Observabilidad, una canalización es un camino secuencial con tres tipos de componentes:
- Fuente: Recibe datos de su fuente de datos (por ejemplo, el Agente de Datadog).
- Procesadores: Enriquecen y transforman sus datos.
- Destinos: Donde se envían sus datos procesados.
Puede crear una canalización con uno de los siguientes métodos:
Consulte Exportar una Configuración de Canalización a JSON o Terraform si desea implementar programáticamente una canalización creada en la interfaz de usuario.
Configurar una canalización en la interfaz de usuario
Configura los componentes de la canalización
- Navega a Pipelines de Observabilidad.
- Selecciona una plantilla basada en tu caso de uso.
- Selecciona y configura tu fuente.
- Agrega procesadores para transformar, redactar y enriquecer tus datos de registro. Nota: Para un lienzo de canalización, hay un límite de 25 grupos de procesadores y un total de 150 procesadores.
- Si deseas copiar un procesador, haz clic en el ícono de copiar para ese procesador y luego usa
command-v para pegarlo.
- Selecciona y configura destinos para tus registros procesados.
Agrega o elimina componentes
Agrega otro grupo de procesadores
If you want to add another group of processors for a destination:
- Click the plus sign (+) at the bottom of the existing processor group.
- Click the name of the processor group to update it.
- Optionally, enter a group filter. Only data that match the filter query are sent through the processors in the group. See Search Syntax for more information.
- Click Add to add processors to the group.
- If you want to copy all processors in a group and paste them into the same processor group or a different group:
- Click the three dots on the processor group.
- Select Copy all processors.
- Select the desired processor group, and then paste the processors into it.
- You can toggle the switch to enable and disable the processor group and also each individual processor.
Notes:
- There is a limit of 25 processor groups for a pipeline canvas.
Agrega otro conjunto de procesadores y destinos
If you want to add another set of processors and destinations, click the plus sign (+) to the left of the processor group to add another set of processors and destinations to the source.
To delete a processor group, you need to delete all destinations linked to that processor group. When the last destination is deleted, the processor group is removed with it.
Agrega otro destino a un grupo de procesadores
If you want to add an additional destination to a processor group, click the plus sign (+) to the right of the processor group.
To delete a destination, click on the trash icon to the top right of the destination.
- If you delete a destination from a processor group that has multiple destinations, only the deleted destination is removed.
- If you delete a destination from a processor group that only has one destination, both the destination and the processor group are removed.
Notes:
- A pipeline must have at least one destination. If a processor group only has one destination, that destination cannot be deleted.
- You can add a total of 20 destinations for a pipeline.
- If you add multiple destinations of the same type to a pipeline, you must use Secrets Management. For example, if you add two HTTP Client destinations for two different HTTP clients, you must use secret identifiers for the HTTP client URIs. You cannot use the default
DESTINATION_HTTP_CLIENT_URI to store the two different HTTP client URIs.
La gobernanza de etiquetas métricas está en vista previa. Complete el
formulario para solicitar acceso.
- Navega a Observability Pipelines.
- Seleccione la plantilla de Gobernanza de Etiquetas Métricas.
- Configure la fuente de Agente de Datadog.
- Agregue procesadores para filtrar y transformar sus métricas. Nota: Para un lienzo de pipeline, hay un límite de 25 grupos de procesadores y un total de 150 procesadores.
- Si desea copiar un procesador, haga clic en el ícono de copiar para ese procesador y luego péguelo (
Cmd+V en Mac, Ctrl+V en Windows/Linux).
- Configure el destino de Métricas de Datadog.
Agregue otro grupo de procesadores
If you want to add another group of processors for a destination:
- Click the plus sign (+) at the bottom of the existing processor group.
- Click the name of the processor group to update it.
- Optionally, enter a group filter. Only data that match the filter query are sent through the processors in the group. See Search Syntax for more information.
- Click Add to add processors to the group.
- If you want to copy all processors in a group and paste them into the same processor group or a different group:
- Click the three dots on the processor group.
- Select Copy all processors.
- Select the desired processor group, and then paste the processors into it.
- You can toggle the switch to enable and disable the processor group and also each individual processor.
Notes:
- There is a limit of 25 processor groups for a pipeline canvas.
Instale el Worker y despliegue la canalización
Después de haber configurado su fuente, procesadores y destinos, haga clic en Siguiente: Instalar. Consulte Instalar el Worker para obtener instrucciones sobre cómo instalar el Worker para su plataforma. Consulte Configuraciones Avanzadas del Worker para opciones de arranque.
Si desea realizar cambios en su canalización después de haberla desplegado, consulte Actualizar Canalizaciones Existentes.
Habilite monitores listos para usar para su canalización
- Navegue a la página de Canalizaciones y encuentre su canalización.
- Haga clic en Habilitar monitores en la columna Monitores para su canalización.
- Haga clic en Iniciar para configurar un monitor para uno de los casos de uso sugeridos.
- El monitor métrico está configurado según el caso de uso seleccionado. Puede actualizar la configuración para personalizarla aún más. Consulte la documentación del monitor métrico para más información.
Configure una canalización con la API
Utilice la API de Observability Pipelines para crear una canalización. Consulte la referencia de la API para ejemplos de cargas útiles de solicitudes.
Después de crear la canalización, instale el Worker para enviar datos a través de la canalización.
- Consulte Variables de Entorno para la lista de variables de entorno que necesita para las diferentes fuentes, procesadores y destinos al instalar el Worker.
Utilice el endpoint de actualizar una canalización para realizar cualquier cambio en una canalización existente.
Consulte Configuraciones Avanzadas del Worker para opciones de arranque.
Puede utilizar el módulo datadog_observability_pipeline para crear un pipeline utilizando Terraform.
Después de crear el pipeline, instale el Worker para enviar datos a través del pipeline.
- Consulte Variables de Entorno para la lista de variables de entorno que necesita para las diferentes fuentes, procesadores y destinos al instalar el Worker.
Utilice el módulo datadog_observability_pipeline para realizar cualquier cambio en un pipeline existente.
Consulte Configuraciones Avanzadas del Worker para opciones de arranque.
Clone un pipeline
Para clonar un pipeline en la interfaz de usuario:
- Navegue a Observability Pipelines.
- Seleccione el pipeline que desea clonar.
- Haga clic en el engranaje en la parte superior derecha de la página, luego seleccione Clonar.
Eliminar un pipeline
Para eliminar un pipeline en la interfaz de usuario:
- Navegue a Pipelines de Observabilidad.
- Seleccione el pipeline que desea eliminar.
- Haga clic en el engranaje en la parte superior derecha de la página, luego seleccione Eliminar.
Nota: No puede eliminar un pipeline activo. Debe detener todos los Workers de un pipeline antes de poder eliminarlo.
Requisitos y límites del pipeline
- Un pipeline debe tener al menos un destino. Si un grupo de procesadores solo tiene un destino, ese destino no puede ser eliminado.
- Para pipelines de logs:
- Puede agregar un total de tres destinos para un pipeline de logs.
Lectura adicional
Documentación, enlaces y artículos útiles adicionales: