Flare del Agent

Un flare permite enviar la información necesaria para que el equipo de asistencia de Datadog pueda solucionar tu problema.

Esta página cubre:

Un flare reúne todos los archivos de configuración y registros del Agent en un archivo de almacenamiento. Elimina información confidencial, incluyendo contraseñas, claves de API, credenciales proxy y cadenas de comunidad SNMP. Si APM está habilitado, el flare incluye logs de depuración del rastreador cuando están disponibles.

El Datadog Agent funciona en su totalidad con código abierto, lo que permite comprobar el comportamiento del código. Si es necesario, puedes revisar el flare antes de enviarlo, ya que este solicita una confirmación antes de subirlo.

Cuando te pongas en contacto con el servicio de asistencia de Datadog con la configuración remota activada para el Agent, el equipo podrá iniciar un flare desde tu entorno para poder ayudarte mejor y de forma más rápida. Los flares proporcionan información de solución de problemas al servicio de asistencia de Datadog para ayudarte a resolver tu problema.

Enviar un flare desde el sitio de Datadog

El envío de un flare del Agent desde Fleet Automation no es compatible con este sitio.

Para enviar un flare desde el sitio de Datadog, asegúrate de haber habilitado la automatización de flotas y la configuración remota en el Agent.

To send a remote flare:

  1. From the Fleet Automation page, select an Agent that requires support.
  2. Click Support.
  3. Click Send Support Ticket.
  4. Provide an existing Zendesk support ticket number. If you don’t provide a ticket number, one is created on your behalf.
  5. Enable Debug mode to allow Datadog support staff to troubleshoot your issue faster. The log level is reset to its previous configuration after you send the flare.
  6. If you are troubleshooting your application, enable application tracer level logs to be included in the flare.
  7. Click Send Ticket.
El botón Enviar tique lanza un formulario para eviar un flare para un tique de asistencia nuevo o existente

Envía un flare utilizando el comando flare

Utiliza el subcomando flare para enviar un flare. En los comandos siguientes, sustituye <CASE_ID> por tu ID de caso de asistencia Datadog, si tienes uno, y luego introduce la dirección de correo electrónico asociada a él.

Si no tienes un ID de caso, introduce la dirección de correo electrónico que utilizaste para iniciar sesión en Datadog para crear un nuevo caso de asistencia.

Confirma la carga del archivo para enviarlo inmediatamente al servicio de asistencia de Datadog.

    PlataformaComando
    AIXdatadog-agent flare <CASE_ID>
    Dockerdocker exec -it dd-agent agent flare <CASE_ID>
    macOSdatadog-agent flare <CASE_ID> o a través de la web de GUI
    CentOSsudo datadog-agent flare <CASE_ID>
    Debiansudo datadog-agent flare <CASE_ID>
    Kuberneteskubectl exec -it <AGENT_POD_NAME> -- agent flare <CASE_ID>
    Fedorasudo datadog-agent flare <CASE_ID>
    RedHatsudo datadog-agent flare <CASE_ID>
    Susesudo datadog-agent flare <CASE_ID>
    Fuentesudo datadog-agent flare <CASE_ID>
    Windows& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID>
    HerokuConsulta la documentación de Heroku específica.
    PCFsudo /var/vcap/jobs/dd-agent/packages/dd-agent/bin/agent/agent flare <CASE_ID>

    Contenedores exclusivos

    Cuando utilizas el Agent v7.19 o posterior y el gráfico de Helm de Datadog con la última versión o un DaemonSet donde el Datadog Agent y Trace Agent están en contenedores separados, se implementa un pod del Agent que contiene:

    • Un contenedor con el proceso del Agent (Agent + Log Agent)
    • Un contenedor con el proceso del Agent de proceso
    • Un contenedor con el proceso del Agent de rastreo
    • Un contenedor con el proceso de system-probe

    Para obtener un flare de cada contenedor, ejecuta los siguientes comandos:

    Agent

    kubectl exec -it <AGENT_POD_NAME> -c agent -- agent flare <CASE_ID>

    Agent de proceso

    kubectl exec -it <AGENT_POD_NAME> -c process-agent -- agent flare <CASE_ID> --local

    Trace Agent

    kubectl exec -it <AGENT_POD_NAME> -c trace-agent -- agent flare <CASE_ID> --local

    Agent de seguridad

    kubectl exec -it <AGENT_POD_NAME> -c security-agent -- security-agent flare <CASE_ID>

    System-probe

    El contenedor system-probe no puede enviar un flare, por lo que obtiene logs del contenedor:

    kubectl logs <AGENT_POD_NAME> -c system-probe > system-probe.log

    ECS Fargate

    Cuando utilizas la plataforma ECS Fargate v1.4.0, puedes configurar tareas y servicios de ECS para permitir el acceso a contenedores Linux en ejecución, habilitando Amazon ECS Exec. Después de habilitar Amazon ECS Exec, ejecuta el siguiente comando para enviar un flare:

    aws ecs execute-command --cluster <CLUSTER_NAME> \
    --task <TASK_ID> \
    --container datadog-agent \
    --interactive \
    --command "agent flare <CASE_ID>"

    Nota: ECS Exec solo puede habilitarse para tareas nuevas. Hay que volver a crear las tareas existentes para utilizar ECS Exec.

    PlataformaComando
    Kuberneteskubectl exec -n <NAMESPACE> -it <CLUSTER_POD_NAME> -- datadog-cluster-agent flare <CASE_ID>
    Cloud Foundry/var/vcap/packages/datadog-cluster-agent/datadog-cluster-agent-cloudfoundry flare -c /var/vcap/jobs/datadog-cluster-agent/config <CASE_ID>

    Envío manual

    El protocolo de flares del Agent recopila configuraciones y logs en un archivo de almacenamiento ubicado en primer lugar en el directorio local /tmp. Si tienes algún problema con la conectividad del Agent, recupera este archivo de forma manual y envíalo al servicio de asistencia.

    Kubernetes

    Para obtener el archivo de almacenamiento en Kubernetes, utiliza el comando kubectl:

    kubectl cp datadog-<pod-name>:tmp/datadog-agent-<date-of-the-flare>.zip flare.zip -c agent

    Referencias adicionales

    Más enlaces, artículos y documentación útiles:

    Modo de depuración del AgentDOCUMENTACIÓN more more Consultar el estado de un check del AgentDOCUMENTACIÓN more more