Configuraciones avanzadas del Worker

Documentación > Observability Pipelines > Configuración > Install the Worker > Configuraciones avanzadas del Worker

Descripción general

Este documento explica el arranque para el Observability Pipelines Worker, otras opciones de configuración del Worker y cómo habilitar el punto de conexión de verificación de estado y las sondas de actividad y preparación.

Opciones de arranque

Todas las rutas de archivos de configuración especificadas en la canalización deben estar bajo /DD_OP_DATA_DIR/config. Modificar archivos en esa ubicación mientras OPW se está ejecutando podría tener efectos adversos.

Realice el arranque del Observability Pipelines Worker dentro de su infraestructura antes de configurar una canalización. Estas variables de entorno son independientes de las variables de entorno de la canalización. La ubicación de los directorios y archivos relacionados:

Directorio de datos predeterminado: /var/lib/observability-pipelines-worker
Archivo de arranque: /etc/observability-pipelines-worker/bootstrap.yaml
Archivo de variables de entorno: /etc/default/observability-pipelines-worker

Nota: DD_OP_DATA_DIR solo puede ser propiedad de un único Observability Pipelines Worker. Si tiene varios Workers, debe usar directorios de datos únicos.

Para establecer las opciones de arranque, realice una de las siguientes acciones:

Use variables de entorno.
Cree un bootstrap.yaml e inicie la instancia del Worker con --bootstrap-config /path/to/bootstrap.yaml.

A continuación se presenta una lista de opciones de arranque, sus variables de entorno de canalización relacionadas y cuál de ellas, el valor de arranque o la variable de entorno, tiene mayor precedencia (prioridad) si ambos se han establecido.

api: Variable de entorno de canalización: DD_OP_API_ENABLED; Prioridad: DD_OP_API_ENABLED; Un ejemplo de configuración:;     api:
        enabled: true
        address: "127.0.0.1:8686" # optional; Nota: Establecer address es opcional. Es la dirección de red a la que debe vincularse la API. Si está ejecutando el Worker en un contenedor de Docker, vincúlelo a 0.0.0.0. De lo contrario, la API no se expone fuera del contenedor.; Descripción: Habilite la API del Observability Pipelines Worker para que pueda ver los procesos del Worker con el comando tap o top. Consulte Ejecutar, interceptar o supervisar el Worker para obtener más información. Si está utilizando los gráficos de Helm proporcionados al configurar una canalización, entonces la API ya se ha habilitado. De lo contrario, asegúrese de que la variable de entorno DD_OP_API_ENABLED esté establecida en true en /etc/observability-pipelines-worker/bootstrap.yaml. Esto configura la API para que escuche en localhost y el puerto 8686, que es lo que espera la CLI para tap.

Consulte Habilitar sondeo de actividad y preparación sobre cómo exponer el punto de conexión /health.
api_key: Variable de entorno de canalización: DD_API_KEY; Prioridad: DD_API_KEY; Descripción: Cree una clave de Datadog API para esta variable de entorno. Remote Configuration debe estar habilitada para la clave de API. Consulte Security considerations para obtener información sobre las salvaguardas implementadas para Remote Configuration.
data_dir: Variable de entorno de canalización: DD_OP_DATA_DIR; Prioridad: DD_OP_DATA_DIR; Descripción: El directorio de datos (opcional, predeterminado: /var/lib/observability-pipelines-worker). Este es el directorio del sistema de archivos que utiliza el Observability Pipelines Worker para el estado local.
pipeline_id: Variable de entorno de canalización: DD_OP_PIPELINE_ID; Prioridad: DD_OP_PIPELINE_ID; Descripción: Cree un ID de canalización de Observability Pipelines para esta variable de entorno.
proxy: Variables de entorno de canalización: DD_PROXY_HTTP, DD_PROXY_HTTPS, DD_PROXY_NO_PROXY; Establezca servidores proxy para el Observability Pipelines Worker. La configuración de proxy para el Observability Pipelines Worker funciona de la misma manera que para el Datadog Agent.; Prioridad: Los ajustes se aplican a todo el proceso del Observability Pipelines Worker. Los valores de proxy HTTP y HTTPS se resuelven en este orden:
   1. DD_PROXY_HTTP(S)
   2. HTTP(S)_PROXY
   3. proxy :; Un ejemplo de configuración de proxy:;     proxy:
        enabled: true
        https: https://foo.bar:3128; Descripción: El Observability Pipelines Worker puede enrutar solicitudes externas a través de proxies de reenvío, como Squid. Los proxies de reenvío reenvían las solicitudes del cliente desde el Observability Pipelines Worker a internet. Puede usarlos como un firewall web para prohibir o permitir ciertos dominios, puertos o protocolos. Los proxies de reenvío generalmente no terminan SSL y, por lo tanto, no tienen acceso al contenido de la solicitud. Solo pasan paquetes de un lado a otro entre el cliente y el destino. Los túneles HTTP se utilizan para asegurar la comunicación a través de un proxy de reenvío.; Notas:; Esta opción está disponible para Observability Pipelines Worker 2.1 y versiones posteriores.; El Observability Pipelines Worker no puede enrutar solicitudes externas a través de proxies inversos, como HAProxy y NGINX.; Las DD_PROXY_HTTP(S) y HTTP(S)_PROXY variables de entorno deben estar ya exportadas en su entorno para que el Worker pueda resolverlas. No se pueden anteponer al script de instalación del Worker.
secret: Variable de entorno de canalización: Ninguna; Prioridad: N/A; Descripción: Conecta el Worker a su administrador de secretos. Consulte Gestión de secretos para obtener información sobre la configuración.
site: Variable de entorno de canalización: DD_SITE; Prioridad: DD_SITE; Descripción: Su sitio de Datadog (opcional, valor predeterminado: datadoghq.com).; Consulte Introducción a los sitios para obtener más información.
tags: []: Variable de entorno de canalización: DD_OP_TAGS; Prioridad: DD_OP_TAGS; Descripción: Las etiquetas reportadas con métricas internas y que pueden utilizarse para filtrar instancias de Observability Pipelines para implementaciones de Remote Configuration.
threads: Variable de entorno de canalización: DD_OP_THREADS; Prioridad: DD_OP_THREADS; Descripción: El número de hilos que se utilizarán para el procesamiento (opcional, valor predeterminado: el número de núcleos disponibles).

Otras opciones de configuración del Worker

Utilice la variable de entorno VECTOR_HOSTNAME para asignar un nombre de host único y ayudarle a identificar el Worker.

Habilite el punto de conexión de verificación de estado y los sondeos de actividad y preparación

Configure la verificación de estado de su balanceador de carga con el punto de conexión /health para verificar que el Worker esté en funcionamiento.

Para Kubernetes, los sondeos de actividad y preparación ya están habilitados en el helm chart y en el archivo values.yaml.

Para otras instalaciones, como las basadas en VM, debe establecer DD_OP_API_ENABLED en true y establecer DD_OP_API_ADDRESS en 0.0.0.0:8686 para exponer el punto de conexión /health. Un ejemplo de configuración:

api:
  enabled: true
  address: "0.0.0.0:8686"

Lecturas adicionales

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

Redactar datos con Observability PipelinesDOCUMENTACIÓN

Actualizar canalizaciones existentesDOCUMENTACIÓN