Commande flare de l'Agent
Un flare vous permet d’envoyer les informations de dépannage nécessaires à l’équipe de support de Datadog.
Cette page couvre :
Une flare rassemble tous les fichiers de configuration et journaux de l’Agent dans un fichier d’archive. Elle supprime les informations sensibles, y compris les mots de passe, les clés API, les identifiants de proxy et les chaînes de communauté SNMP. Si APM est activé, le flare inclut les journaux de débogage du traceur lorsqu’ils sont disponibles.
L’Agent Datadog est entièrement open source, ce qui vous permet de vérifier le comportement du code. Si nécessaire, le flare peut être examiné avant l’envoi, car le flare demande une confirmation avant de le téléverser.
Lorsque vous contactez Datadog Support avec Remote Configuration activée pour un Agent, l’équipe de support peut initier un flare depuis votre environnement afin de mieux vous aider dans les meilleurs délais. Les flares fournissent des informations de dépannage au support Datadog pour vous aider à résoudre votre problème.
Envoyer un flare depuis le site Datadog
L'envoi d'un flare d'Agent depuis Fleet Automation n'est pas pris en charge pour votre site Datadog sélectionné (
). Utilisez
la soumission manuelle de flare à la place.
Pour envoyer un flare depuis le site Datadog, assurez-vous d’avoir activé Fleet Automation et Remote Configuration sur l’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.
Envoyer un flare en utilisant la commande flare
Envoyer un flare d'Agent en utilisant le
flare la sous-commande n'est pas prise en charge pour votre site Datadog sélectionné (
). Utilisez
la soumission manuelle de flare à la place.
Utilisez la sous-commande flare pour envoyer un flare. Dans les commandes ci-dessous, remplacez <CASE_ID> par votre identifiant de cas de support Datadog si vous en avez un, puis entrez l’adresse e-mail associée.
Si vous n’avez pas d’identifiant de cas, entrez votre adresse e-mail utilisée pour vous connecter à Datadog afin de créer un nouveau cas de support.
Confirmez le téléversement de l’archive pour l’envoyer immédiatement au support Datadog.
| Plateforme | Commande |
|---|
| AIX | datadog-agent flare <CASE_ID> |
| Docker | docker exec -it dd-agent agent flare <CASE_ID> |
| macOS | datadog-agent flare <CASE_ID> ou via le 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> |
| Source | sudo datadog-agent flare <CASE_ID> |
| Windows | & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID> |
| Heroku | Consultez la Heroku documentation |
| PCF | sudo /var/vcap/jobs/dd-agent/packages/dd-agent/bin/agent/agent flare <CASE_ID> |
Conteneurs dédiés
Lors de l’utilisation de l’Agent v7.19+ et du Datadog Helm Chart avec la dernière version ou d’un DaemonSet où l’Agent Datadog et le Trace Agent se trouvent dans des conteneurs séparés, vous déployez un Pod Agent contenant :
- Un conteneur avec le processus de l’Agent (Agent + Log Agent)
- Un conteneur avec le processus process-agent
- Un conteneur avec le processus trace-agent
- Un conteneur avec le processus system-probe
Pour obtenir un flare de chaque container, exécutez les commandes suivantes :
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
Agent de Trace
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
Le conteneur system-probe ne peut pas envoyer de flare. Vous devez donc récupérer les logs de conteneur :
kubectl logs <AGENT_POD_NAME> -c system-probe > system-probe.log
ECS Fargate
Lors de l’utilisation de la plateforme ECS Fargate v1.4.0, les tâches et services ECS peuvent être configurés pour permettre l’accès aux conteneurs Linux en cours d’exécution en activant Amazon ECS Exec. Après avoir activé Amazon ECS Exec, exécutez la commande suivante pour envoyer un flare:
aws ecs execute-command --cluster <CLUSTER_NAME> \
--task <TASK_ID> \
--container datadog-agent \
--interactive \
--command "agent flare <CASE_ID>"
Remarque : ECS Exec ne peut être activé que pour de nouvelles tâches. Vous devez recréer les tâches existantes pour utiliser ECS Exec.
| Plateforme | Commande |
|---|
| 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> |
Soumission manuelle
Le protocole de flare de l’Agent collecte les configurations et les journaux dans un fichier d’archive situé d’abord dans le répertoire local /tmp.
Obtenez ce fichier manuellement et fournissez-le au support s’il y a des problèmes de connectivité avec l’Agent.
Kubernetes
Pour obtenir le fichier d’archive dans Kubernetes, utilisez la commande kubectl :
kubectl cp datadog-<pod-name>:tmp/datadog-agent-<date-of-the-flare>.zip flare.zip -c agent
Lectures complémentaires
Documentation, liens et articles supplémentaires utiles:
