mcpField
D
dt-obs-extensions

dt-obs-extensions

github.com/dynatraceその他1729 回インストール今日更新
リポジトリ

dt-obs-extensions について

Dynatrace Extensions Skillは、Dynatrace利用者がインストール済み拡張機能と監視設定を確認し、問題を調査するためのスキルです。DQLによる状態照会、イベントログ、エラーコード資料を使って診断します。

主な機能

  1. 01拡張機能の設定状態を確認
  2. 02拡張機能のイベントログを照会
  3. 03状態とエラーコードを解釈
  4. 04対処方法を参照

活用シーン

  1. 01OK以外の拡張状態を調査
  2. 02拡張機能の再起動を診断
  3. 03データが生成されない原因を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dynatrace/dynatrace-for-ai --skill dt-obs-extensions

インストール後、Claude Code で/dt-obs-extensionsを入力して読み込まれたか確認します。

同梱ファイルreferences/extensions-error-codes.md

詳細

Dynatrace 拡張機能スキル

概要

Dynatrace 拡張機能を使用すると、外部システムやカスタムデータソースと連携して、Dynatrace の機能を拡張できます。

このスキルを使用する場面：

  • インストール済みの拡張機能とその監視設定のステータスを確認する
  • DQL クエリとイベントログを使用して、拡張機能の設定に関する問題をトラブルシューティングする

拡張機能のライフサイクル

拡張機能をインストールすると、アセット（ダッシュボード、アラートテンプレート、OpenPipeline ルールなど）が追加されます。インストール後、各拡張機能には複数の有効化設定（監視設定）を作成できます。設定は ActiveGate または OneAgent で実行でき、それぞれ個別に有効化／無効化できます。各設定には独自のステータスがあり、このスキルを使用して照会できます。

拡張機能の監視設定とステータス

拡張機能のステータス

拡張機能のステータスを確認するには、次の DQL クエリを実行します。

timeseries count(dt.sfm.extension.config.status), by: {dt.extension.name, dt.extension.config.id, dt.extension.status}
  • dt.extension.name — 拡張機能名
  • dt.extension.config.id — 監視設定 ID
  • dt.extension.status — 現在のステータス値
2. 拡張機能のイベントログを取得する

ステータスが OK でない場合は、詳細ログを取得します。

fetch dt.system.events
| filter dt.extension.name == "<extension_name>" AND dt.extension.config.id == "<config_id>"

content フィールドでエラーコードを確認します。エラーコードの形式は DEC:[A-Z0-9_]+ です。

→ エラーコードの意味と対処方法については、references/extensions-error-codes.md で該当するコードを検索してください（エラーコードリファレンスを参照）。

拡張機能ステータスのリファレンス

ステータス意味対処方法
OK問題なく実行中なし
STARTUP / STARTUP_PENDING / STARTUP_SCHEDULED拡張機能の起動中起動が完了するまで待ちます
RESTART / TIMED_OUT_RESTART拡張機能の再起動中監視します。繰り返し発生する場合は、ログを確認します
IDLE動作中ですが、ステータスが生成されていません通常は一時的な状態です
WARNING警告状態拡張機能のログを確認します
GENERIC_ERRORエラー状態拡張機能のログを確認します
STARTUP_ERROR起動中にエラーが発生しました拡張機能のログと設定を確認します
HIGH_CPU / HIGH_CPU_RESTARTCPU 使用率が過剰ですActiveGate の設定でパフォーマンスプロファイルを切り替えます
HIGH_MEMORY / HIGH_MEMORY_RESTARTメモリー使用量が過剰ですActiveGate の設定でパフォーマンスプロファイルを切り替えます
EEC_HARD_LIMIT_REJECTION / EEC_HARD_LIMIT_RESTARTリソースのハードリミットに達しましたActiveGate の設定でパフォーマンスプロファイルを切り替えます
EEC_RESTSERVER_ERRORREST API のポートが競合していますホスト上でポートの競合がないか確認します
EXTENSIONS_CACHE_ERROR拡張機能をダウンロードできませんActiveGate／OneAgent のディスク容量を確認します
EXTENSION_VERIFICATION_ERRORextension.yaml の形式が正しくありませんextension.yaml の構文を検証します
CUSTOM_CODE_EXTENSION_NOT_ALLOWEDカスタムコードがブロックされていますActiveGate または OneAgent を更新します
INCOMPATIBLE_API_ERRORAPI のバージョンが一致しませんActiveGate／OneAgent を更新するか、拡張機能のドキュメントを確認します
MAX_TASKS_LIMIT_REJECTIONタスクが多すぎますグループに ActiveGate を追加するか、グループを分割します
MISSING_BINARY / MISSING_DATASOURCEインストールの形式が正しくありませんActiveGate または OneAgent を再インストールします
GROUP_NAME_CHANGE一時的な再調整中です再調整が完了するまで待ちます

トラブルシューティング

よくある問題

  1. 拡張機能のステータスが OK ではない

    • 上記のステータス照会を実行して、具体的なステータスコードを特定します
    • ステータスのリファレンステーブルで対処方法を確認します
    • 不明な場合は、拡張機能のイベントログを取得します

  2. イベントログ内のエラーコード

    • エラーコードは DEC:[A-Z0-9_]+ の形式です
    • references/extensions-error-codes.md でコードを検索します（下記の［エラーコードのリファレンス］(#error-code-reference)を参照）
    • エラーコードがない場合は、詳細を確認するためにイベントの content を読みます

  3. 拡張機能が再起動を繰り返す

    • HIGH_CPU_RESTART、HIGH_MEMORY_RESTART、または TIMED_OUT_RESTART がないか確認します
    • ActiveGate の設定で、より高いパフォーマンスプロファイルに切り替えます
    • 拡張機能の設定を確認し、対象範囲が過剰になっていないか確認します

  4. 拡張機能がデータを生成しない

    • ステータスが OK（IDLE またはエラー状態ではない）であることを確認します
    • 監視設定が有効になっていることを確認します
    • 監視対象システムへのネットワーク接続を確認します

エラーコードのリファレンス

references/extensions-error-codes.md は大きな自動生成ファイルです。各エントリは次の構成になっています。

## Error Code DEC:<code>

### Error Description: <description>

### Suggestions:

1. ...

ファイル全体を読み込まないでください。 references/extensions-error-codes.md で該当するエラーコードの見出し（例：## Error Code DEC:1D6）を検索し、その次の約 50 行を読みます。次の ## Error Code 見出しで読み込みを止めます。

参照

コメント

Markdown 対応