Flare de agente

Una señal te permite enviar información necesaria para la solución de problemas al equipo de soporte de Datadog.

Esta página cubre:

Un flare reúne todos los archivos de configuración y registros del agente en un archivo. Elimina información sensible, incluyendo contraseñas, claves de API, credenciales de proxy y cadenas de comunidad SNMP. Si APM está habilitado, la señal incluye registros de depuración de trazadores cuando están disponibles.

El agente de Datadog es completamente de código abierto, lo que te permite verificar el comportamiento del código. Si es necesario, la señal puede ser revisada antes de enviarla, ya que la señal solicita una confirmación antes de cargarla.

Al contactar al Soporte de Datadog con Remote Configuration habilitado para un agente, el equipo de soporte puede iniciar un flare desde su entorno para ayudarle de manera oportuna. Los flares proporcionan información de solución de problemas al Soporte de Datadog para ayudarle a resolver su problema.

Enviar un flare desde el sitio de Datadog

Enviar un flare de agente desde Fleet Automation no es compatible con su sitio de Datadog seleccionado (). Usa envío manual de flares en su lugar.

Para enviar un flare desde el sitio de Datadog, asegúrese de haber habilitado Fleet Automation y Remote Configuration en el Agente.

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 Send Ticket lanza un formulario para enviar un flare para un ticket de soporte existente o nuevo.

Envía un flare usando el comando flare

Enviando un flare de agente usando el flare el subcomando no es compatible con su sitio de Datadog seleccionado (). Usa envío manual de flares en su lugar.

Usa el subcomando flare para enviar un flare. En los comandos a continuación, reemplace <CASE_ID> con su ID de caso de soporte de Datadog, si tiene uno, y luego ingrese la dirección de correo electrónico asociada con él.

Si no tiene un ID de caso, ingrese la dirección de correo electrónico utilizada para iniciar sesión en Datadog para crear un nuevo caso de soporte.

Confirme la carga del archivo para enviarlo de inmediato al Soporte 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 interfaz web
    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>
    HerokuConsulte la documentación dedicada de Heroku
    PCFsudo /var/vcap/jobs/dd-agent/packages/dd-agent/bin/agent/agent flare <CASE_ID>

    Contenedores dedicados

    Al usar el Agente v7.19+ y el Chart de Helm de Datadog con la última versión o un DaemonSet donde el Agente de Datadog y el Agente de Trazas están en contenedores separados, despliega un Pod de Agente que contiene:

    • Un contenedor con el proceso del Agente (Agent + Log Agent)
    • Un contenedor con el proceso Process Agent
    • Un contenedor con el proceso Trace Agent
    • Un contenedor con el proceso system-probe

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

    Agente

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

    Process Agent

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

    Agente de Trazas

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

    Agente de Seguridad

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

    Sondeo del sistema

    El contenedor system-probe no puede enviar un flare, así que obtenga los registros del contenedor en su lugar:

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

    ECS Fargate

    Al usar la plataforma ECS Fargate v1.4.0, las tareas y servicios de ECS pueden configurarse para permitir el acceso a contenedores de Linux en ejecución habilitando Amazon ECS Exec. Después de habilitar Amazon ECS exec, ejecute el siguiente comando para enviar una señal:

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

    Nota: ECS Exec solo se puede habilitar para nuevas tareas. Debe recrear las tareas existentes para usar 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 flare del Agente recopila archivos de configuración y registros en un archivo ubicado inicialmente en el directorio local /tmp. Obtenga manualmente este archivo y proporciónelo al soporte si hay algún problema con la conectividad del Agente.

    Kubernetes

    Para obtener el archivo en Kubernetes, use el comando kubectl:

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

    Para saber más

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

    Modo de depuración del agenteDOCUMENTACIÓN more more Obtener el estado de una verificación de agenteDOCUMENTACIÓN more more