Un flare le permite enviar la información de solución de problemas necesaria al equipo de soporte de Datadog.
Esta página cubre:
Un flare recopila todos los archivos de configuración y registros del Agent en un archivo comprimido. Elimina información confidencial, incluyendo contraseñas, claves de API, credenciales de proxy y cadenas de comunidad SNMP. Si APM está habilitado, el flare incluye registros de depuración del trazador cuando están disponibles.
El Datadog Agent es completamente de código abierto, lo que le permite verificar el comportamiento del código. Si es necesario, el flare puede revisarse antes de enviarlo, ya que el flare solicita una confirmación antes de cargarlo.
Al contactar al soporte de Datadog con Remote Configuration habilitado para un Agent, el equipo de soporte puede iniciar un flare desde su entorno para ayudarle mejor de manera oportuna. Los flares proporcionan información de solución de problemas a Datadog Support para ayudarle a resolver su problema.
Enviar un flare desde el sitio de Datadog
El envío de un Agent Flare desde Fleet Automation no es compatible con el sitio de Datadog seleccionado (
). Utilice
envío manual de flare en su lugar.
Para enviar un flare desde el sitio de Datadog, asegúrese de haber habilitado Fleet Automation y Remote Configuration en el Agent.
To send a remote flare:
- From the Fleet Automation page, select an Agent that requires support.
- Click Support.
- Click Send Support Ticket.
- Provide an existing Zendesk support ticket number. If you don’t provide a ticket number, one is created on your behalf.
- 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.
- If you are troubleshooting your application, enable application tracer level logs to be included in the flare.
- Click Send Ticket.
Envíe un flare usando el flarecomando
El envío de un Agent Flare usando el
flare subcomando no es compatible con el sitio de Datadog seleccionado (
). Utilice
envío manual de flare en su lugar.
Utilice el flare subcomando para enviar un flare. En los comandos a continuación, reemplace <CASE_ID> con su ID de incidencia de soporte de Datadog si tiene uno, luego ingrese la dirección de correo electrónico asociada con él.
Si no tiene un ID de incidencia, ingrese la dirección de correo electrónico que usa para iniciar sesión en Datadog para crear una nueva incidencia de soporte.
Confirme la carga del archivo para enviarlo inmediatamente al soporte de Datadog.
| Plataforma | Comando |
|---|
| AIX | datadog-agent flare <CASE_ID> |
| Docker | docker exec -it dd-agent agent flare <CASE_ID> |
| macOS | datadog-agent flare <CASE_ID> o a través de la web GUI |
| CentOS | sudo datadog-agent flare <CASE_ID> |
| Debian | sudo datadog-agent flare <CASE_ID> |
| Kubernetes | kubectl exec -it <AGENT_POD_NAME> -- agent flare <CASE_ID> |
| Fedora | sudo datadog-agent flare <CASE_ID> |
| Redhat | sudo datadog-agent flare <CASE_ID> |
| Suse | sudo datadog-agent flare <CASE_ID> |
| Fuente | sudo datadog-agent flare <CASE_ID> |
| Windows | & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID> |
| Heroku | Consulte la documentación dedicada de Heroku |
| PCF | sudo /var/vcap/jobs/dd-agent/packages/dd-agent/bin/agent/agent flare <CASE_ID> |
Contenedores dedicados
Al usar Agent v7.19+ y usar el Helm Chart de Datadog con la versión más reciente o un DaemonSet en el que el Datadog Agent y el Trace Agent están en contenedores separados, usted despliega un Pod de Agent que contiene:
- Un contenedor con el proceso del Agent (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:
Agent
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
Trace Agent
kubectl exec -it <AGENT_POD_NAME> -c trace-agent -- agent flare <CASE_ID> --local
Security Agent
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, así que obtenga los registros del contenedor en su lugar:
kubectl logs <AGENT_POD_NAME> -c system-probe > system-probe.log
ECS Fargate
Para ECS Fargate, Datadog recomienda enviar un flare desde el sitio de Datadog. En Fleet Automation, identifique su tarea mediante su ARN de tarea. Este proceso no requiere ningún cambio en su tarea o servicio de ECS.
Alternativamente, si Remote Configuration no está disponible o necesita ejecutar otros comandos del Agent, utilice Amazon ECS Exec. Plataforma ECS Fargate v1.4.0. Para usarla:
- Agregue los permisos de ECS Exec a la definición de tarea.
- Habilite ECS Exec en el servicio.
- Vuelva a implementar la tarea.
- Ejecute 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>"
| Plataforma | Comando |
|---|
| Kubernetes | kubectl 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 Agent recopila configuraciones y registros en un archivo comprimido que se encuentra primero en el directorio local /tmp.
Obtenga este archivo manualmente y proporciónelo al soporte técnico si hay algún problema con la conectividad del Agent.
Kubernetes
Para obtener el archivo comprimido en Kubernetes, use el comando kubectl:
kubectl cp datadog-<pod-name>:tmp/datadog-agent-<date-of-the-flare>.zip flare.zip -c agent
Lecturas adicionales
Documentación, enlaces y artículos útiles adicionales:
