Taegis Endpoint Agent for macOS トラブルシューティング

このドキュメントでは、エージェントの問題に関して Secureworksサポート へ支援依頼を行う前に実施できる初期トラブルシューティング手順および収集可能な情報について説明します。

ヒント

追加のTaegisエンドポイントエージェントのトラブルシューティング、チュートリアル、および情報記事は、Secureworksナレッジベースでご覧いただけます。

診断

バージョン1.4.9でリリースされた新しい診断機能では、以下の2つの操作が可能です。

• サポートに送信するための情報をアーカイブファイルに収集するモード。これにより、サポートチームがシステム詳細を個別に要求する必要がなくなり、問題解決までの時間が短縮されます。
• すべてのエージェントコンポーネントの構成および実行時の動作を分析し、対応が必要な項目についてフィードバックを提供するトラブルシューティングモード。

GUI メソッド

推奨されるエージェントUIから診断機能へアクセスし利用するには、以下の手順を実施してください。

1. メニューバーからTaegisアイコンを選択し、Open Secureworks Taegis を選択します。

   

   Open Secureworks Taegis

2. アプリの左側ナビゲーションメニューから Diagnostics を選択します。

   

   Diagnostics

情報の収集

サポートに共有するためのログやシステム情報を1つのアーカイブファイルにまとめて収集するには、以下の手順を実施してください。

1. Collect information for support を選択してセクションを展開し、Run を選択します。これにより以下が収集されます。

   • すべてのエージェントログ
   • エージェント構成
   • MDMプロファイル構成
   • システム情報

   

   Collect Information

2. 完了すると、情報は taegisctl-diag-XXXXX.tgz ファイルに圧縮されます。Open in Finder を選択して、サポートに送信するファイルへアクセスします。

   

   Access Archive

トラブルシュート

セットアップや環境に関する問題の診断を試みるためにトラブルシュートツールを実行するには、以下の手順を実施してください。

1. Troubleshoot を選択してセクションを展開し、Run を選択します。これによりエージェント構成が分析され、すべてのエージェント設定の簡単なサマリーが出力されます。

   

   Diagnostics Troubleshooting

2. 完了すると、結果として以下のいずれかのステータスが表示されます。

   • Pass — チェックに合格
   • Fail — チェックに失敗しており、調査が必要
   • Warn — チェックは問題ない可能性もあるが、潜在的な問題を示す場合がある
   • NA — 該当なし

   

   Troubleshooting Output

コマンドライン（ターミナル）メソッド

診断ツールはコマンドライン（ターミナル）からも実行できます。

注意

診断コマンドは sudo 権限で実行する必要があります。

情報の収集

サポートに共有するためのログやシステム情報を1つのアーカイブファイルにまとめて収集するには、以下のコマンドを使用してください。

/Applications/SecureworksTaegis.app/Contents/bin/taegisctl gather

Diagnostics Troubleshooting (Terminal)

トラブルシュート

トラブルシュートツールを実行するには、以下のコマンドを使用してください。

/Applications/SecureworksTaegis.app/Contents/bin/taegisctl troubleshoot

Troubleshooting Output (Terminal)

インストール

• モバイルデバイス管理（MDM）を使用する場合は、MDM展開 に記載の該当記事に従ってください。
• MDM以外でインストールする場合は、UI展開手順 に従ってください。
• メニューバーのステータスアイコンからTaegisを開き、Open Secureworks Taegis を選択して、フルディスクアクセスが付与されていること、およびシステム拡張機能が許可されていることを確認してください。

自動アップグレード失敗

• ログに明らかなエラーがないか確認してください: log stream --level debug --predicate 'subsystem == "scwx"'
• taegis-agent-prod-builds.s3.us-east-2.amazonaws.com をファイアウォールで許可してください。
• taegis-agent-prod-builds.s3.us-east-2.amazonaws.com への接続性を確認したら、テナントに移動し、対象のエンドポイントで Reconnect を選択してください。

サービスが起動しない

Consoleアプリを開き、エージェントのクラッシュレポート（secureworks でフィルタ）を確認してください。加えて、クラッシュファイルは /Library/Logs/DiagnosticReports にも保存されています。

アンインストール

• Appleのバグにより、アンインストール後もアクティブなシステム／ネットワーク拡張が残る場合があります。エージェントはOSへの依存のため、これを回避できません。
• system.log やアプリケーションのクラッシュレポートなどのログは、さらなる診断に役立つ場合があります。