Agent フレア

フレアを使用すると、必要なトラブルシューティング情報を Datadog のサポートチームに送信できます。

このページでは、以下の内容を説明しています。

フレアは Agent のすべての構成ファイルを収集し、1 つのアーカイブファイルに記録します。パスワード、API キー、プロキシ資格情報、SNMP コミュニティ文字列などの機密情報は削除されます。APM が有効な場合、利用可能であればトレーサーデバッグログも含まれます。

Datadog Agent は完全にオープンソースなので、コードの動作を検証することができます。フレアは、アップロードの前に確認を求めるため、必要に応じて送信前にフレアを確認できます。

Agent で Remote Configuration が有効な状態で Datadog Support に問い合わせる際、サポートチームは迅速な対応のために貴社の環境からフレアを起動する場合があります。フレアにはトラブルシューティング情報が含まれており、Datadog Support に提供されることで問題解決を支援します。

Datadog サイトからフレアを送信する

選択した Datadog サイトでは、Fleet Automation からの Agent Flare の送信はサポートされていません ()。代わりにフレアの手動送信を使用してください。

Datadog サイトからフレアを送信するには、Agent の Fleet Automation とリモート構成が有効になっていることを確認してください。

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.
Send Ticket ボタンは、既存または新規のサポートチケットに対してフレアを送信するためのフォームを起動します

flare コマンド{#send-a-flare-using-the-flare-command}を使用してフレアを送信する

選択した Datadog サイト flare () では、サブコマンドを使用した Agent Flare の送信はサポートされていません。代わりにフレアの手動送信を使用してください。

フレアを送信するには flare サブコマンドを使用してください。以下のコマンドで、<CASE_ID> を実際の Datadog サポートケース ID (ある場合) に置き換え、それに紐づけされているメールアドレスを入力します。

ケース ID がない場合は、Datadog へのログインに使用するメールアドレスを入力して新しいサポートケースを作成します。

アーカイブのアップロードを確認し、直ちに Datadog サポートに送信してください。

    プラットフォームコマンド
    AIXdatadog-agent flare <CASE_ID>
    Dockerdocker exec -it dd-agent agent flare <CASE_ID>
    macOSdatadog-agent flare <CASE_ID> またはウェブ 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>
    Sourcesudo datadog-agent flare <CASE_ID>
    Windows& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID>
    Heroku個別の Heroku ドキュメントを参照してください
    PCFsudo /var/vcap/jobs/dd-agent/packages/dd-agent/bin/agent/agent flare <CASE_ID>

    専用コンテナ

    Agent v7.19 以降を使用し、Datadog Helm Chart を最新バージョンで使用するか、Datadog Agent と Trace Agent が別々のコンテナにある DaemonSet を使用する場合は、以下を含む Agent Pod をデプロイします。

    • Agent プロセスを含む 1 つのコンテナ (Agent + Log Agent)
    • process-agent プロセスを含む 1 つのコンテナ
    • trace-agent プロセスを含む 1 つのコンテナ
    • システムプローブプロセスを含む 1 つのコンテナ

    各コンテナからフレアを取得するには、次のコマンドを実行します。

    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>

    システムプローブ

    システムプローブコンテナはフレアを送信できないため、代わりにコンテナログを取得します。

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

    ECS Fargate

    ECS Fargate プラットフォーム v1.4.0 を使用する場合、Amazon ECS Exec を有効にすることで、実行中の Linux コンテナへのアクセスを許可するように ECS タスクとサービスを構成できます。Amazon ECS Exec が有効化されたら、次のコマンドを実行してフレアを送信します。

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

    注: ECS Exec は新しいタスクに対してのみ有効にできます。ECS Exec を使用するには、既存のタスクを再作成する必要があります。

    プラットフォームコマンド
    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>

    手動送信

    Agent フレアプロトコルは、コンフィギュレーションとログをまずローカルの /tmp ディレクトリにあるアーカイブファイルに収集します。 Agent のデータ収集に問題がある場合は、このファイルを手動で取得してサポートに送信してください。

    Kubernetes

    Kubernetes でアーカイブファイルを取得するには、kubectl コマンドを使用します。

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

    参考資料

    お役に立つドキュメント、リンクや記事:

    Agent デバッグモードドキュメント more more Agent チェックのステータスを確認ドキュメント more more