Last9

公式

リアルタイムの本番コンテキスト(ログ、メトリクス、トレース)をシームレスにローカル環境に取り込み、コードの自動修正をより迅速に行えるようにします。

Last9 MCPで何ができますか?

  • 本番環境のインシデントを調査する — アシスタントにログ、トレース、メトリクス、例外、発報中のアラートをサービスから取得させ、何が壊れたのかを診断します。
  • 変更と影響を関連付ける — デプロイや設定変更を確認し、変更によるリグレッションがないか、変更前後のサービスとその呼び出し元を比較します。
  • Prometheusのメトリクスをクエリする — PromQLの範囲クエリまたは瞬時クエリを実行し、データソース内の任意のメトリクスを調べるためにラベル値を一覧表示します。
  • データベースのパフォーマンスを調査する — データベースを検出し、実行時間の長いクエリを見つけ、OTelスパンからクエリのパターンとサーバー側のメトリクスを確認します。
  • トレースとプロファイルを分析する — IDでトレースのウォーターフォールを取得し、コホート間の属性の偏差を順位付けするか、サービスのフレームグラフと上位関数を取得します。
  • アラートとダッシュボードを管理する — アラートの網羅性と健全性を確認し、アラートルールを作成または修正し、カスタムダッシュボードを一覧表示、検証、編集します。

ドキュメント

Last9 MCP Server

last9 mcp demo

AI エージェントは、本番環境で何が壊れているのかを把握できません。これで解決できます。

Last9 MCP Server は、Claude、Cursor、Windsurf、その他の MCP 対応 AI アシスタントを、本番環境の可観測性データ(ログ、メトリクス、トレース、例外、データベースクエリ、アラート、デプロイ)に直接接続します。エージェントは推測をやめ、実際のシグナルを読み取るようになります。


30 秒で開始(ホスト型)

バイナリのインストールは不要です。トークンの管理も不要です。URL を 1 つ使い、ブラウザーで OAuth を完了すれば準備完了です。

Last9 の URL で組織のスラッグを確認します: app.last9.io/<org_slug>/...

Claude Code

claude mcp add --transport http last9 https://app.last9.io/api/v4/organizations/<org_slug>/mcp

/mcp と入力し、last9 を選択して認証します。これで完了です。

Cursor

Settings > MCP > Add New MCP Server:

{
  "mcpServers": {
    "last9": {
      "type": "http",
      "url": "https://app.last9.io/api/v4/organizations/<org_slug>/mcp"
    }
  }
}

Connect をクリックし、OAuth を完了します。

VS Code

v1.99 以降が必要です。コマンド パレットを開き、MCP: Add Server を選択して URL を貼り付け、認証します。

または、settings.json に直接追加します:

{
  "mcp": {
    "servers": {
      "last9": {
        "type": "http",
        "url": "https://app.last9.io/api/v4/organizations/<org_slug>/mcp"
      }
    }
  }
}

Windsurf

Settings > Cascade > Open MCP Marketplace > gear icon (mcp_config.json):

{
  "mcpServers": {
    "last9": {
      "serverUrl": "https://app.last9.io/api/v4/organizations/<org_slug>/mcp"
    }
  }
}

Claude Web/Desktop

Settings > Connectors > Add custom connector. 名前に last9 を指定し、URL を貼り付けて認証します。

Claude 組織の管理者アクセス権が必要です。


セルフホスト(STDIO)

MCP クライアントが HTTP トランスポートに対応していない場合、またはサーバーをローカルで実行する必要がある場合に使用します。

インストール

Homebrew:

brew install last9/tap/last9-mcp

NPM:

Node.js 22.23.4 以降、24.22.1 以降、または 26.12.1 以降が必要です。それ以前のリリースでは、インストーラーがバイナリをダウンロードする際に、侵害された eMudhra 中間証明書からの TLS 証明書を受け入れます。

npm install -g @last9/mcp-server@latest
# or directly:
npx -y @last9/mcp-server@latest

バイナリリリース(Windows / 手動):

GitHub Releases からダウンロードします:

プラットフォームアーカイブ
Windows (x64)last9-mcp-server_Windows_x86_64.zip
Windows (ARM64)last9-mcp-server_Windows_arm64.zip
Linux (x64)last9-mcp-server_Linux_x86_64.tar.gz
Linux (ARM64)last9-mcp-server_Linux_arm64.tar.gz
macOS (x64)last9-mcp-server_Darwin_x86_64.tar.gz
macOS (ARM64)last9-mcp-server_Darwin_arm64.tar.gz

Refresh Token を取得する

トークンを作成できるのは管理者のみです。

  1. API Access に移動します
  2. 書き込み権限を指定して Generate Token をクリックします
  3. コピーします

クライアントの設定

Homebrew:

{
  "mcpServers": {
    "last9": {
      "command": "/opt/homebrew/bin/last9-mcp",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

NPM:

{
  "mcpServers": {
    "last9": {
      "command": "npx",
      "args": ["-y", "@last9/mcp-server@latest"],
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

貼り付け先:

クライアント場所
Claude Web/DesktopSettings > Developer > Edit Config (claude_desktop_config.json)
CursorSettings > Cursor Settings > MCP > Add New Global MCP Server
WindsurfSettings > Cascade > MCP Marketplace > gear icon (mcp_config.json)
VS Codesettings.json 内で { "mcp": { "servers": { ... } } } で囲みます — 詳細
VS Code STDIO config
{
  "mcp": {
    "servers": {
      "last9": {
        "type": "stdio",
        "command": "/opt/homebrew/bin/last9-mcp",
        "env": {
          "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
        }
      }
    }
  }
}

NPM の場合: "command": "npx" を使用し、"args": ["-y", "@last9/mcp-server@latest"] を追加します。

Windows

GitHub Releases からダウンロードした後、展開して完全なパスを指定します:

{
  "mcpServers": {
    "last9": {
      "command": "C:\\Users\\<user>\\AppData\\Local\\Programs\\last9-mcp-server.exe",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

Windows では NPM を使う方法が簡単です。パスを管理する必要がありません。

環境変数

変数デフォルト説明
LAST9_REFRESH_TOKEN(必須)API Access から取得した Refresh Token
LAST9_DATASOURCE組織のデフォルトデータソース/クラスター名 — Levitate クラスターが複数ある場合に便利です
LAST9_FAKE_NOW_ISO(未設定)評価/リプレイ専用。本番環境では絶対に設定しないでください。 RFC3339 の時刻(例: 2026-01-02T15:04:05Z)。lookback_minutes などの相対ウィンドウを解決する際に現在時刻を置き換え、実行を再現可能にします。無効な値は起動エラーになります。タイムアウト、キャッシュ、トークンの有効期限には実際の時刻が使われます
LAST9_API_HOSTapp.last9.ioAPI ホストを上書きします
LAST9_TOOLSETSすべてのツール公開するツールセットをカンマ区切りで指定します(logs、traces、metrics、alerts、dashboards、profiles、grafana、investigate、all)。別名: LAST9_MCP_TOOLSETS
LAST9_MCP_READ_ONLYfalse読み取り専用ツールのみを提供するには true を設定します。読み取り専用モード を参照してください。ブール値以外の値は起動エラーになります。別名: LAST9_READ_ONLY
LAST9_MCP_ALLOW_WRITE_TOOLS—読み取り専用モードでも提供する書き込みツールをカンマ区切りで指定します。別名: LAST9_ALLOW_WRITE_TOOLS
LAST9_MAX_GET_LOGS_ENTRIES5000分割された get_logs リクエストの最大エントリ数
LAST9_USE_LOG_SEARCH_APIfalsetrue を設定すると、get_logs と get_service_logs に対して、クライアント側で分割せず、サーバー側の検索呼び出し 1 回で応答します。各呼び出しのタイムアウトは 90 秒です。その後、ウィンドウを絞り込むよう案内が返されます。502 または 503 は、その時間内に 1 回再試行されます
LAST9_DEBUG_CHUNKINGfalsetrue を設定すると、get_logs、get_service_logs、get_traces のチャンク計画の詳細をログに記録します
LAST9_DISABLE_TELEMETRYtruefalse を設定すると、内部 OTel トレーシングを有効にします
OTEL_SDK_DISABLED—標準の OTel 環境変数です。LAST9_DISABLE_TELEMETRY を上書きします
OTEL_EXPORTER_OTLP_ENDPOINT—OTLP コレクターのエンドポイント(テレメトリが有効な場合のみ)
OTEL_EXPORTER_OTLP_HEADERS—OTLP 認証ヘッダー(テレメトリが有効な場合のみ)

ツールのフェーズ別タイミング

内部テレメトリが有効な場合、ツールのスパンには last9.phase.<phase>.duration_ms (実際の経過時間、ミリ秒)と last9.phase.<phase>.failed(そのフェーズが エラーを返したかどうか)が含まれます。同じフィールドは、設定されたロガーがデバッグレコードを受け付ける場合、 tool phase completed デバッグログとして、tool と phase とともに出力されます。 これらのタイミング情報によって、入力、クエリテキスト、認証情報、エラー本文が追加されることはありません。

ツールフェーズ
get_log_patternssample: サンプルの取得とデコード、mine: パターンのマイニング、deep_link: オプションのインデックス解決とリンクの作成
get_logsfetch: 再試行やオプションの件数整合性チェックを含む、結果の取得、デコード、マージ、count_sanity: ネストされたオプションのチェック、post_process: ガイダンス、要約、JSON 形式への変換、deep_link: インデックスの解決とリンクの作成
get_service_profilerequest: 共有 API クライアントを通じたリクエストの準備と送信、および簡潔な形式への変換前の完全なレスポンスの読み取り

失敗した取得を含め、実行されたフェーズのみが記録されます。エラーを抑制するオプションのヘルパーは、その動作を維持します。failed: false があっても、オプションのリンクや件数チェックが利用可能だったことを保証するものではありません。ネストされた count_sanity の所要時間は、すでに fetch に含まれています。二重に加算しないでください。取得時間にはクライアント側の処理も含まれるため、バックエンドの実行時間だけを測定するものではありません。サンプリングやキャッシュを調整する前に、同等のウィンドウと検索パスでこれらのフェーズを比較してください。

レイテンシを調査するには、ベースラインと候補ビルドで、同じサービス、データソース、インデックス、ウィンドウ、制限値を使ってリプレイします。ビルド SHA、ツール全体の所要時間、フェーズごとの所要時間、last9.logs.search_path、存在する場合は再試行属性、カバレッジフラグを記録します。典型的な呼び出しだけでなく、遅い呼び出しも比較してください。取得やプロファイルのリクエストが遅い場合は、調査すべきネットワーク/API フェーズを特定できます。テールレイテンシをバックエンドに帰属させるには、相関する別の証拠が必要です。これらの診断情報だけでは、レイテンシが改善したとは判断できません。

読み取り専用モード

--read-only(または LAST9_MCP_READ_ONLY=true)を使うと、readOnlyHint: true の注釈が付いたツールのみが提供されます。そのため、ツールからアラートルール、通知チャネル、ダッシュボード、ドロップルールを作成、変更、削除したり、アラートの確認や再割り当て、グループのミュートを行ったりすることはできません。注釈のないツールは書き込みツールとして扱われ、非表示になります。

一部の書き込みツールを残すには、--allow-write-tools(または LAST9_MCP_ALLOW_WRITE_TOOLS)で指定します:

last9-mcp --read-only --allow-write-tools=acknowledge_alert,mute_alert_group
  • 許可リストに書き込みツールではない名前(タイプミスや読み取りツール名)が含まれている場合、サーバーは起動を拒否し、有効な書き込みツールをエラーに表示します。
  • --read-only を指定せずに --allow-write-tools を指定すると、すべての書き込みツールがすでに提供されているため、起動エラーになります。
  • 読み取り専用モードは --toolsets と組み合わせて使用できます。ツールは両方の条件を満たす場合にのみ提供されます。--toolsets=alerts --read-only --allow-write-tools=mute_alert_group はアラートの読み取りツールと mute_alert_group を提供します。選択したツールセットに含まれない許可済みの書き込みツールは非表示のままです。
  • --http モードと dump-tools は同じフラグと環境変数に従います。go run . dump-tools --read-only は読み取り専用のツール一覧を、提供されるサーバー指示とともに instructions に出力します。
  • 読み取りツールの説明、スキーマ、結果、およびサーバー指示には、非表示の書き込みツールの名前は含まれません。ただし、許可された書き込みツールが、非表示の関連ツール名を示す場合があります(create_alert は無効なルールを作成し、patch_alert がそれを有効にします)。そのため、このようなツールの組み合わせは一緒に許可してください。

できること

概要

  • get_workspace_overview — リクエストでサービスやツールが指定されていない場合に推奨される最初の呼び出しです(指定されている場合は、該当するツールに直接進みます)。環境、直近 1 時間に確認されたシグナル(ログ、トレース、メトリクス)、サービス数とアラートグループ数、発火中のアラート、現在時刻を、低コストの 1 回の呼び出しで取得します。その 1 時間に確認されなかったシグナルにも古いデータが存在する可能性があるため、引き続きクエリできます。サブ呼び出しが失敗すると、そのフィールドは null となり、errors[] エントリが追加されます。すべてのツールセットで提供されます
  • get_current_time — 現在時刻と、任意の IANA タイムゾーンまたは一般的な略称における last 2h、yesterday、since yesterday 9am IST の絶対境界を返します。すべてのツールセットで提供されます

サービスの健全性

  • get_service_summary — フリート全体の (service, env) 行を順位付けして表示します。期間内の request_count、throughput_rpm、HTTP 4xx/5xx 件数、gRPC エラー件数が含まれます
  • get_service_environments — サービスで利用可能な環境を表示します。最初に実行してください。他の APM ツールでは、ここで取得した env が必要です
  • get_service_performance_details — 詳細な内訳を表示します。スループット、エラー率、p50/p90/p95/平均/最大、apdex、可用性が含まれます(デフォルトでは要約を表示し、include_series を指定すると全系列を表示します)
  • get_service_operations_summary — HTTP エンドポイント、DB 呼び出し、メッセージング、HTTP クライアントごとに操作をグループ化します
  • get_service_dependency_graph — 上流/下流/インフラのスループット、レイテンシ、エラー率を含む依存関係マップを表示します
  • get_apm_service_deviations — 現在のウィンドウを同じ長さのベースラインと比較します。回帰/改善、Apdex の整合性確認、最終的な結果(フリート全体または単一サービス)を表示します
  • get_exceptions — サービスとスパンのフィルターを指定して、サーバー側の例外を表示します

データベースの可観測性

データベースのパフォーマンスを直接調べる 4 つのツールです。OpenTelemetry のトレーススパンから導出され、トレースがない場合は CloudWatch などのインフラメトリクスから導出されます。すでに OTel を使用している場合、追加の計装は不要です。

  • get_databases — インフラストラクチャ全体のデータベースを検出します。DB の種類、ホスト、スループット(クエリ/分)、p95 レイテンシ、エラー率、依存サービス数を確認できます。CloudWatch などのインフラストラクチャメトリクスからもデータベースを検出します。トレースの計装は不要で、該当する行にはトレースメトリクスの代わりにアクティビティ値が表示されます
  • get_database_slow_queries — 実際に最も遅いクエリ実行を所要時間順に表示し、完全なトレースを確認するためのトレース ID も示します
  • get_database_queries — クエリパターンと集計情報を表示します。クエリの実行頻度、平均/p95 所要時間、エラー率を確認できます
  • get_database_server_metrics — DB ホスト自体のサーバー側メトリクス(CPU、接続数、バッファヒット率など。DB システムによって異なります)

PostgreSQL、MySQL、MongoDB、Redis、Aerospike、および db_system 属性を持つ OTel トレースに対応するその他のデータベースをサポートします。また、CloudWatch などのインフラストラクチャメトリクスから検出されたデータベースにも対応します。該当する行にはトレースメトリクスの代わりにアクティビティ値が表示されます。

Prometheus / PromQL

  • prometheus_range_query — 任意のメトリクスに対する PromQL の範囲クエリ
  • prometheus_instant_query — インスタントクエリ。avg_over_time、sum_over_time などのロールアップ関数を使用します
  • prometheus_label_values — 指定した系列のラベル値
  • prometheus_labels — 系列で利用可能なすべてのラベル

LAST9_DATASOURCE を設定するか、呼び出しごとに datasource を指定すると、デフォルトとは異なるデータソース/クラスターを対象にできます。datasource を省略するとデフォルトが使用されます。マッチャーが安全と判断する一意の近似一致(大文字・小文字の違いなど)は、最も近い一致が使用されます。文字の欠落、余分な文字、入れ替わりがあっても、自動的に解決されるとは限りません。編集によってリージョンや環境コードが変わる可能性がある場合は、候補が 1 つだけでも確認が必要になることがあります。あいまいな一致や許容範囲の広い一致では候補が返され、クエリは実行されません(エラーではありません)。不明な名前の場合はエラーが返されます。データソース名を正確に指定しなかった場合は、使用されたデータソース名を示す追加のコンテンツブロックが返されます。get_metric_status、get_service_profile、get_apm_service_deviations も同じ方法で datasource を解決します。

ログ

  • get_logs — 集計、フィルター、フィールド抽出に対応する、完全な JSON パイプラインログクエリ
  • get_service_logs — サービスのログ行。重大度と本文の内容でフィルタリングできます。response_mode が raw でない限り、20 行を超える結果は要約されます
  • get_log_patterns — 指定期間内のサービスのログ行をメッセージテンプレートごとにクラスタリングし、件数、初回/最終確認時刻、重大度の内訳、サンプルを表示します
  • get_emerging_log_patterns — ベースライン期間と比較して、新規、増加、減少、または消失したログテンプレートを、両期間の件数とともに表示します
  • get_log_attributes — 指定期間のログスキーマに含まれる属性のグローバルカタログ
  • get_log_attributes_for_pipeline — 進行中のパイプラインに実際に存在するログフィールド(対象を絞った検出)。各フィールドの正確な filter_field も表示します
  • get_drop_rules — Last9 Control Plane のログドロップルール
  • add_drop_rule — ソースでログ量を削減するための新しいドロップルールを作成します
  • get_remapping_rules — Last9 Control Plane のリマッピングルール(logs_extract、logs_map、traces_map)
  • add_remapping_rule — 取り込み時にログ属性やトレース属性を抽出またはマッピングするリマッピングルールを作成します

トレース

  • get_traces — 広範な検索や集計に対応する JSON パイプライントレースクエリ
  • get_service_traces — 正確なトレース ID またはサービス名でトレースを検索します。トレース ID がある場合はこちらを使用してください。より高速です
  • get_trace_attributes — トレーススキーマに含まれる属性のグローバルカタログ
  • get_trace_attributes_for_pipeline — 進行中のパイプラインに実際に存在する属性(対象を絞った検出)。各属性の正確な filter_field も表示します
  • get_trace_attribute_values — トレース属性の個別の値。必要に応じてパイプラインを指定できます
  • get_trace_attribute_deviations — 2 つの範囲指定されたスパンコホート(低速と高速、エラーと非エラー、または 2 つの期間)で異なる属性値を順位付けします。相関を示すものであり、原因を示すものではありません
  • get_trace_waterfall — 1 つの正確なトレースを親子ウォーターフォールとして表示し、区間の和集合に基づくセルフタイム、最も遅いスパン、グラフの警告を示します

変更イベントとアラート

  • get_change_events — デプロイ、設定変更、ロールバックを表示します。インシデントと変更内容を関連付けます
  • analyze_change_impact — 変更によって問題が発生したかを確認します。変更前後のサービスと直接の呼び出し元を比較し、ゴールデンシグナル、APM とトレース属性の偏差、新たに発火したアラート、判定(regression likely / no significant change / insufficient data)を表示します
  • get_alert_groups — メタデータラベル、チーム、ティア、ルール数を含む、設定済みの Compass アラートグループ。ルールが 0 件のグループや、発火していないグループも含みます
  • get_alert_operations_summary — 指定期間のオンコール状況を表示します。発生したアラートと確認済みアラート、未処理件数、配信状況を確認できます。また、include_rules を指定すると、最もノイズの多いルール、頻繁に状態が変化するルール、ルーティングされていないルールも表示します。すべての件数には status(available / partial / unavailable)が付属します
  • get_alert_coverage — アラート対象になっていない項目を表示します。カバーされていないゴールデンシグナル、完全に無効化またはルーティングされていないアラートグループ、長期間ミュートされているルールを、それぞれ推奨修正ツールとともに示します。読み取り専用です
  • get_alert_config — アラートルールの設定。名前、重大度、種類、タグで検索できます
  • get_entity_kpis — 1 つのアラートグループにあるすべての KPI(ID、名前、PromQL、単位)。まだどのルールにも使われていない KPI も含みます。ID は create_alert と validate_alert_expression で必要です
  • create_kpi — 既存の KPI が適合しない場合に、アラートグループに KPI(PromQL + 単位)を作成します。一度だけ作成し、返された ID を保持してください
  • get_alerts — 指定期間内に現在発火中のアラート
  • get_alert_rule_state — 時間範囲内の各アラートルールについて、発火状態(1/0)の履歴を rule_id ごとにグループ化して表示します。アラートグループ、ルール名、ラベルフィルター、状態でフィルタリングできます
  • get_alert_hygiene — 過去 7 日または 30 日間の、ノイズの多いルール、頻繁に状態が変化するルール、古いルール、ルーティングされていないルールを順位付けして表示します。判定の根拠となる数値と推奨修正も示します。読み取り専用です
  • get_notification_channels — 設定済みの通知チャネル(Slack、PagerDuty、メールなど)。scope=channels はチャネル自体(関連付けに使う ID)を一覧表示し、デフォルトの attached はアラートグループごとの関連付けを一覧表示します
  • recommend_alert_config — アラートルールを作成する前に確認する、読み取り専用の設計ガイダンス(ライフサイクル、検証ゲート、対応者向けコンテキスト)
  • validate_alert_expression — アラートグループの KPI に対してアラート式をドライランし、何も保存しません
  • describe_alert_chart — Discover チャートでアラート可能なシグナル(キー、単位)を読み取り専用で表示します(discover-service、discover-exceptions)
  • create_alert — 既存のアラートグループにアラートルールを作成します(静的、または adaptive_std_cmp による適応型)。常に無効なドラフトとして作成されます。一度作成した後、update_alert / patch_alert で調整してください
  • create_alert_from_chart — Discover チャートから静的しきい値のアラートルールを 1 回の呼び出しで作成します。create_alert と同様に、ルールは無効なドラフトとして作成されます
  • update_alert — ルールの評価設定を完全に置き換えます(置き換え後のルール ID が返される場合があります)
  • patch_alert — ルールを部分的に変更します。有効化/一時停止、mute_until、対応者 properties、週次 recurring_mute_schedule(または clear_recurring_mute_schedule)
  • delete_alert — アラートルールを完全に削除します
  • mute_alert_group — アラートグループ内のすべてのルールを期限までミュート(またはミュート解除)します
  • acknowledge_alert — 発火中のアラートを引き受けるか、担当を解除します
  • reassign_alert — すでに確認済みのアラートを別のユーザーに引き継ぎます
  • create_notification_channel — Slack、PagerDuty、Opsgenie、メール、または汎用 Webhook チャネルを作成します
  • attach_notification_channel — 既存のチャネルをアラートグループに関連付け、breach、threat、またはその両方に使用します
  • detach_notification_channel — チャネルとアラートグループの関連付けを 1 件削除します
  • delete_notification_channel — 関連付けのないチャネルを完全に削除します

アラート書き込みツール(create_kpi、create_alert、update_alert、patch_alert、delete_alert、create_alert_from_chart、mute_alert_group、acknowledge_alert、reassign_alert、create_notification_channel、attach_notification_channel、detach_notification_channel、delete_notification_channel)には書き込みスコープを持つトークンが必要です。delete_alert、detach_notification_channel、delete_notification_channel には代わりに削除スコープが必要です。これらは alerts ツールセットでのみ公開されます。

これらのツールで作成されたルール、チャネル、関連付けには、MCP クライアントの名前とバージョンとともに created_via: last9-mcp が付与されます(ルールでは _l9_created_via_ と _l9_created_via_client_ の注釈が付与され、patch_alert と update_alert はそれらを保持します。呼び出し元が設定することはできません)。get_entity_alert_rules と get_notification_channels でマーカーを確認できます。また、delete_alert、detach_notification_channel、delete_notification_channel は、ユーザーが指定しない限り、マークされたリソースのみをクリーンアップするようエージェントに指示します。

カスタムダッシュボード

  • list_dashboards — 名前で絞り込み、32 KB 未満のページに分割したカスタムダッシュボード一覧。ID、名前、最終更新日時、作成者、ロック状態を表示します
  • get_dashboard — パネルやクエリを含む、ID で指定したダッシュボードの完全な定義
  • preview_dashboard — 未保存のダッシュボードまたはパッチを読み取り専用でプレビューします。解決済みクエリ、パネルごとに上限を設けた結果、パネル差分の概要を表示し、保存はしません
  • validate_dashboard — 保存済みダッシュボード ID またはインラインの dashboard_definition を対象に、24 時間以内の期間で読み取り専用の lint、実行、分類を行います。ダッシュボードの作成や更新は行いません
  • create_dashboard — 新しいカスタムダッシュボードを一度だけ作成します(パネル、クエリ、メタデータ)。ID が返された後は、patch_dashboard でパネルを編集してください
  • update_dashboard — ID で指定した既存のダッシュボードの大部分を再構成します(完全置換。読み取り専用のシステムダッシュボードではエラーが返されます)。個別のパネル編集には patch_dashboard を使用してください
  • patch_dashboard — ID で指定した既存のダッシュボードを対象に、追加/更新/削除/移動によるパネル編集、タイトル設定、変数設定を行います。ダッシュボード全体ではなく、簡潔な差分を返します
  • delete_dashboard — ID で指定したカスタムダッシュボードを削除します
  • set_dashboard_lock — ID で指定したカスタムダッシュボードをロックまたはロック解除します(作成者または組織管理者のみ)。ロック中のダッシュボードは更新、パッチ適用、削除を拒否します
  • list_dashboard_snapshots — ダッシュボードの時点固定スナップショット(メタデータのみ)
  • get_dashboard_snapshot — RCA や共有可能なビュー向けの、パネルデータを含む完全な時点固定スナップショット
  • delete_dashboard_snapshot — ID で指定した時点固定スナップショットを削除します

ダッシュボードの作成は、スキルをインストールせずに MCP の prompts/list と prompts/get から利用できます。3 つのプロンプトはいずれも引数を取りません。

  • create_dashboard_guide — 検出、レイアウト、パネル選択を行います。承認前に候補全体を検証し、各パネルのクエリを実行してから一度だけ作成します。対象を絞った編集にはパッチを適用し、その後読み戻します
  • dashboard_examples — サービス RED、エンドポイントレイテンシ、ステータスクラス、ホストの健全性、ログ件数、トレースパネルを、依存変数とともに網羅した完全な例
  • query_guide — カウンター/ゲージ/ヒストグラムと派生トレースメトリクスの意味、インスタントと範囲の違い、レートウィンドウ、パーセンテージの境界、logjson/tracejson のルール

同じ内容は last9://reference/create_dashboard_guide、last9://reference/dashboard_examples、last9://reference/query_guide でも参照できます。プロンプトとリソースはすべてのツールセットで引き続き検出できます。ワークフローの実行には該当するツールが必要です(複数シグナルを扱う作成には --toolsets=dashboards,investigate を使用してください。これは list_datasources にも対応します)。読み取り専用セッションでは準備と検証はできますが、保存はできません。手順に進む前に、ツールが利用可能か確認してください。

パネルのチェックでは現在、validate_dashboard と併せて prometheus_range_query、prometheus_instant_query、get_logs、get_traces を使用します。バリデーターがサポートしていないクエリタイプや簡略化されたデフォルト設定では、レンダリングの同等性は保証されません。別個のクエリチェック手順は、#475 の対応完了後に query_panel に切り替わります。

継続的プロファイリング

組織で継続的プロファイリングが有効になっている必要があります。まず get_profile_services でサービスを検出し、その後フレームグラフまたは関数のランキングを取得してください。

  • get_profile_services — 指定期間内にプロファイリングデータがあるサービス(クエリ前にインデックスを作成)
  • get_flamegraph — 1つのサービスのネストされたフレームグラフツリー(デフォルトは cpu、ほかに alloc、wall)
  • get_top_functions — 1つのサービスで最も負荷の高い関数のセルフサンプルランキング
  • get_profile_summary — 1つのサービスのプロファイルを簡潔な自然言語でトリアージ

Grafana ダッシュボード

組織の Grafana インスタンスに対する読み取り専用ツール(Last9 の Grafana プロキシ経由)。認証情報フィールドがモデルに返されることはありません。LAST9_TOOLSETS=grafana で有効にします(または、すべてのツールを有効にするには toolsets を未設定のままにします)。

  • grafana_search_dashboards — タイトルの部分文字列でダッシュボードを検索(ページネーション対応。上限に達すると truncated: true)
  • grafana_get_dashboard — uid によるダッシュボードの概要(パネル、変数、PromQL ターゲット)。Grafana の生 JSON は full_json=true
  • grafana_list_folders — フォルダツリー
  • grafana_list_folder_dashboards — 1つのフォルダ内のダッシュボード(ページネーション対応)
  • grafana_list_datasources — 認証情報を含まないデータソース一覧

あいまいな名前の解決

  • did_you_mean — エージェントがエンティティ名を特定できない場合、カタログから最も近い候補を返します(サービス、環境、ホスト、データベース、K8s デプロイメント/名前空間、ジョブ)。類似度スコア付きで最大3件を提案します。名前検索で結果が空の場合、サーバーはほとんどのツールの実行前にこれを自動的に呼び出します。

サービスプロファイル

  • get_service_profile — クエリを実行する前に、サービスのテレメトリの実態を確認します。存在するシグナル、言語とランタイム、デプロイ環境、ログの形式、該当する場合は推奨される取り込み修正を示します。サービスにトレースがない場合はエージェントがトレースツールを省略でき、SeverityText が空の場合はそれでフィルタリングして何も見つからない事態を避け、ログ本文から重大度を解析できます。

仕組み

すべての応答にディープリンク。 すべてのツールは deep_link フィールドを返します。これは、該当するクエリと時間範囲を指定した Last9 ダッシュボードへの直接 URL です。エージェントからリンクを受け取り、クリックすれば、すぐに該当画面を開けます。

Toolsets。 デフォルトでは、サーバーはすべてのツールを公開します。調査(ログ/トレース/メトリクス/プロファイル)のみを必要とする自動化ホストは、LAST9_TOOLSETS=investigate を設定する(または --toolsets=investigate を渡す)ことで、クライアント側で大量に無効化しなくても tools/list を小さく保てます。名前付きパック:logs、traces、metrics、alerts、dashboards、profiles、grafana、investigate、all。不明な名前は即座にエラーになります。get_current_time と get_workspace_overview は、すべての toolset で提供されます。HTTP モードでは、X-Last9-Toolsets ヘッダーを使ってリクエストごとにさらに絞り込めます(リクエストごとの toolsets を参照)。alerts パックでは、読み取り専用の prometheus_range_query と get_dashboard も提供され、author-alert プロンプトから呼び出されます。metrics パックだけでは、list_datasources や did_you_mean は含まれません。これらの検出ヘルパーが必要な場合は、investigate を使うか、toolset を組み合わせてください。

ツールリファレンスのリソース。 長い logjson/tracejson/service-logs/metrics のマニュアルは、常時表示されるツール説明文ではなく、MCP リソース(last9://reference/logjson、last9://reference/tracejson、last9://reference/service_logs、last9://reference/metrics、last9://reference/investigation、last9://reference/alerting)です。アラートのマニュアルでは、アラート式の文法、静的フィールドと適応型フィールド、単位、validate_alert_expression が確認する内容、レイテンシ/エラー率/飽和度のルールテンプレートを説明します。重要なクエリルールはツール説明文に残されるため、resources/read を呼び出さないエージェントでも正しいクエリを構築できます。組織固有のフィールドは get_log_attributes / get_log_attributes_for_pipeline(およびトレース用の同等ツール)で確認してください。これらは説明文に挿入されません。

大きな結果の分割取得。 get_logs と get_traces は、大きな結果セットを切り捨てずに分割して処理します。ログのデフォルト上限は5000件で、LAST9_MAX_GET_LOGS_ENTRIES で設定できます。


開発

HTTP モード、curl によるテスト、ソースからのビルド

HTTP モードで実行

export LAST9_REFRESH_TOKEN="your_refresh_token"
export LAST9_HTTP=true
export LAST9_PORT=8080
./last9-mcp-server

サーバーは http://localhost:8080/mcp で起動します。

curl でテスト

Streamable HTTP ハンドラーはステートレスモードで動作するため、各リクエストは個別に処理されます。initialize ハンドシェイクと Mcp-Session-Id ヘッダーは省略可能です。これらを送信するクライアントも引き続き動作します(ヘッダーは受け付けられますが無視されます)。また、クライアントは tools/list / tools/call に直接進むこともできます。各ツールは独立したリクエスト/レスポンスのクエリです。サーバーからクライアントへの通知は送信されないため、GET /mcp(SSE ストリーム)は 405 を返します。

# List tools — a session handshake is optional in stateless mode
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Call a tool
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "tools/call",
      "params": {
        "name": "get_service_logs",
        "arguments": {
          "service_name": "your-service-name",
          "lookback_minutes": 30,
          "limit": 10
        }
      }
    }'

リクエストごとの toolsets

HTTP モードでは、X-Last9-Toolsets ヘッダー、またはヘッダーを設定できないクライアント向けの toolsets クエリパラメーター(/mcp?toolsets=logs,traces)を使って、リクエストで公開するツールを絞り込めます。両方が送信された場合、空白以外の値を持つヘッダーが優先されます。値には --toolsets と同じカンマ区切りの名前を指定します。リクエストで有効になるのは、起動時の --toolsets との共通部分です。絞り込みはできますが、拡張はできません。all または空の値を指定すると、起動時のセットが維持されます。不明な名前を指定すると、その名前を示す 400 が返されます。tools/list、tools/call、initialize の指示はすべて有効なセットに従います。get_current_time と get_workspace_overview は、どのセットにも含まれます。

curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -H "X-Last9-Toolsets: logs,alerts" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

有効なセットごとに専用のサーバーが用意され、初回リクエスト時に構築されます(数十ミリ秒)。その後、シャットダウンまで保持されます。起動時のセットを再指定するリクエストでは、起動時のサーバーが再利用されます。削除処理はありません。名前付き toolset のみが受け付けられるため、キャッシュに保持されるサーバーは組み合わせごとに最大1つです(現在は135通りで、合計のライブヒープは約75 MB。テストでは、キャッシュが満杯になった状態で常駐メモリは約230 MBでした)。

ソースからビルド

git clone https://github.com/last9/last9-mcp-server.git
cd last9-mcp-server
go build -o last9-mcp-server
LAST9_HTTP=true ./last9-mcp-server

LAST9_HTTP=true はローカル開発用です。実際に使用する場合は、ホストされた HTTP エンドポイント のほうが簡単です。


ツールリファレンス

すべてのパラメーター、時間入力の標準、詳細

時間入力

  • 絶対時刻(start_time_iso / end_time_iso、または time_iso)は、lookback_minutes より優先されます。
  • 相対期間には lookback_minutes を使用します。
  • 絶対期間には RFC3339/ISO8601(2026-02-09T15:04:05Z)を使用します。
  • 旧式の YYYY-MM-DD HH:MM:SS は互換性のためにのみ受け付けられます。
  • since yesterday 9am IST のような表現は、get_current_time を使って RFC3339 の開始・終了時刻に変換します。

get_workspace_overview

パラメーターはありません。過去60分間を並行して調査し、各サブコールに短いタイムアウトを設定して、current_time、lookback_minutes、environments、telemetry(logs / traces / metrics のブール値)、service_count(環境ごとの異なるサービスの get_service_summary 順位)、alert_group_count、firing_alert_count、errors([{field, error}])を返します。サブコールに失敗したフィールドは null(不明)となり、0 や false にはなりません。調査対象は --toolsets によって絞り込まれません。toolset は提供するツールを制限し、API トークンはサーバーが読み取れるデータを制限します。

get_current_time

  • range(文字列、任意):last 2h、past 30 minutes、last 7d(s、m、h、d = 24h、w = 7d、最大366d)、today、yesterday、since <point>、<point> to <point>。時点は RFC3339、または today / yesterday / 曜日(monday、mon:今日を含む直近の該当日)/ YYYY-MM-DD として指定でき、任意で 9am、9:30pm、14:30 を付けられます。末尾のタイムゾーンは両方の境界で timezone を上書きします。それ以外の位置にタイムゾーンを指定するとエラーになります。now だけを取得する場合は省略します。
  • timezone(文字列、任意):IANA 名または略称(IST = Asia/Kolkata、PST/PDT、EST/EDT、UTC、GMT)。デフォルトは UTC。不明なタイムゾーンはエラーになります。また、曖昧な CST もエラーになるため、America/Chicago または Asia/Shanghai を渡してください。

now を {iso, epoch_seconds, local} として返します(range を指定した場合は start / end も返します)。local は UTC 以外のタイムゾーンの場合にのみ表示されます。

get_exceptions

  • limit(整数、任意):例外の最大数。デフォルト:20。
  • lookback_minutes(整数、任意):デフォルト:60。
  • start_time_iso / end_time_iso(文字列、任意):絶対時間範囲。
  • service_name(文字列、任意):サービスで絞り込み。
  • span_name(文字列、任意):スパン名で絞り込み。
  • env(文字列、任意):環境で絞り込み。

get_service_summary

  • start_time_iso / end_time_iso(文字列、任意)
  • env(文字列、任意):PromQL 正規表現。デフォルトは .*。完全一致にはアンカーが必要です(例:^prod$)。
  • sort_by(文字列、任意):request_count(デフォルト)、throughput_rpm、http_4xx_count、http_5xx_count、または grpc_error_count。
  • limit(整数、任意):ランキング行の最大数。省略または0の場合は10。100を超える値は100に制限されます。

get_service_environments

  • start_time_iso / end_time_iso(文字列、任意)

その他すべての APM ツールでは、env の値が必要です。これが空の場合は "" を使用してください。

get_service_performance_details

デフォルトでは、系列ごとの概要を返します。points、missing_points(トラフィックがなく、統計から除外された可用性バケット)、min、p50、p90、p99(最近傍順位法)、max、mean、last、baseline_mean(期間全体ではなく、有効なポイントの前半の平均)、delta_pct(有効なポイントの後半とベースラインの比較。ベースラインが0の場合は省略)、および最大3件の change_points(timestamp、before_mean、after_mean)を返します。各メトリクスと応答時間の各分位点について、最大4系列が対象です(平均値の高い順。残りの件数は series_omitted)。points: 0 を持つ系列には統計情報が含まれません。また、baseline_mean / delta_pct の算出には最低6ポイント(各半分に3ポイント)が必要です。full_series は、生のポイントを include_series から取得できることを示します。

  • service_name(文字列、必須)
  • lookback_minutes(整数、任意):デフォルト:60。
  • start_time_iso / end_time_iso(文字列、任意)
  • env(文字列、任意):デフォルトは prod。
  • top_n(整数、任意):top-operations/top-errors リストの最大件数。デフォルトは5、include_series=true の場合は10。最大100。
  • include_series(ブール値、任意):概要の代わりに、すべての系列のすべてのポイントを返します。デフォルト:false。

get_service_operations_summary

  • service_name(文字列、必須)
  • lookback_minutes(整数、任意):デフォルト:60。
  • start_time_iso / end_time_iso(文字列、任意)
  • env(文字列、任意):デフォルトは prod。

get_service_dependency_graph

  • service_name(文字列、任意)
  • lookback_minutes(整数、任意):デフォルト:60。
  • start_time_iso / end_time_iso(文字列、任意)
  • env(文字列、任意):デフォルトは prod。

get_apm_service_deviations

  • service_name (string, optional): フリート全体を対象とする場合は省略します。1つのサービスとその操作の相関関係を対象とする場合は指定します。
  • lookback_minutes (integer, optional): 現在のウィンドウ。デフォルト: 60。
  • start_time_iso / end_time_iso (string, optional): 現在のウィンドウを明示的に指定します。
  • baseline_start_time_iso / baseline_end_time_iso (string, optional): ベースラインを明示的に指定します。デフォルトでは、直前の同じ長さのウィンドウが使用されます。
  • datasource (string, optional): デフォルトを使用する場合は省略します。近似名は Prometheus ツールと同様に解決されます。レスポンスには使用されたデフォルトまたは最も近い一致が示されます。曖昧な名前の場合は、クエリを実行せず候補を返します。
  • env (string, optional): デフォルトは prod です。
  • max_services / max_operations (integer, optional): デフォルトは各 10、最大は各 10 です。

get_databases

  • env (string, optional): 環境でフィルタリングします。正規表現を使用できます。デフォルト: すべて。
  • lookback_minutes (integer, optional): デフォルト: 60。ウィンドウは7日を超えることはできません。
  • start_time_iso / end_time_iso (string, optional)

get_database_slow_queries

  • db_system (string, optional): 例: postgresql、mysql、mongodb、redis。
  • host (string, optional): データベースホスト (net_peer_name)。
  • service_name (string, optional): 呼び出し元のサービス名。
  • env (string, optional)
  • min_duration_ms (float, optional): クエリ時間の最小値 (ms)。
  • lookback_minutes (integer, optional): デフォルト: 60。
  • start_time_iso / end_time_iso (string, optional)
  • limit (integer, optional): デフォルト: 20。

get_database_queries

  • db_system (string, optional)
  • host (string, optional)
  • service_name (string, optional)
  • env (string, optional)
  • lookback_minutes (integer, optional): デフォルト: 60。
  • start_time_iso / end_time_iso (string, optional)
  • limit (integer, optional): デフォルト: 20。

get_database_server_metrics

  • db_system (string, required): 例: postgresql、mysql、mongodb、redis、aerospike。
  • host (string, optional)
  • lookback_minutes (integer, optional): デフォルト: 60。
  • start_time_iso / end_time_iso (string, optional)

prometheus_range_query

  • query (string, required): PromQL クエリ。
  • start_time_iso / end_time_iso (string, optional): デフォルトでは直近60分です。
  • lookback_minutes (float, optional): デフォルト: 60。

prometheus_instant_query

  • query (string, required)
  • time_iso (string, optional): デフォルトでは現在時刻です。
  • lookback_minutes (float, optional)

prometheus_label_values

  • match_query (string, optional): PromQL フィルター。
  • label (string, required): ラベル名。
  • lookback_minutes (float, optional): デフォルト: 60。
  • start_time_iso / end_time_iso (string, optional)

ウィンドウが指定されておらず、match_query が1つのメトリクス (metric{...} または {__name__="metric"}) を示す場合、60分の結果が空なら4日間の範囲で1回再試行します。2つ目のテキストブロックには、結果が対象とするウィンドウが示されます。

prometheus_labels

  • match_query (string, optional): PromQL フィルター。
  • lookback_minutes (float, optional): デフォルト: 60。
  • start_time_iso / end_time_iso (string, optional)

prometheus_label_values と同様に、単一メトリクスの検索結果が空の場合、4日間の範囲で再試行します。

get_logs

  • logjson_query (array, required): JSON パイプラインクエリ。
  • lookback_minutes (integer, optional): デフォルト: 5。
  • start_time_iso / end_time_iso (string, optional)
  • limit (integer, optional): サーバーのデフォルト: 5000。
  • index (string, optional): physical_index:<name> または rehydration_index:<block_name>。
  • response_mode (string, optional): summary (デフォルト。null の場合も同様) または raw。生ログ行の結果が20行を超える場合、summary として返されます: lines_summarized、severity_counts (上位6つのラベル。残りは other_severities にまとめられます)、first_timestamp/last_timestamp、クエリウィンドウ内の10バケットの histogram (返された行を対象とし、上限に達して結果が切り詰められた場合は truncated: true を含みます)、および上位の patterns (template、count、最大2つの samples)。残りは other に合算され、全体は最大4000文字です。収まらないトップレベルのメタデータは削除され、dropped_fields に記載されます。raw はログ行を返します。集計結果は要約されません。

ログベースのサービスインベントリを取得するには、まず physical_index_service_count をクエリします。

sum by (name, service_name, env) (physical_index_service_count{destination="logs"})

service_name を ServiceName として使用し、環境がある場合は env を環境として、name を物理インデックス名として使用します。name="default" の場合は index を省略します。ユーザーがデフォルト以外の物理インデックスを選択した場合は、index: "physical_index:<name>" を渡します。バックエンドが物理インデックスの明示的なフィルタリングを拒否した場合は、index を指定せずに再試行し、そのバックエンドでは物理インデックスの明示的なフィルタリングが利用できないことを報告します。

get_service_logs

  • service_name (string, required)
  • lookback_minutes (integer, optional): デフォルト: 60。
  • limit (integer, optional): デフォルト: 100。response_mode: "raw" の場合は20。
  • env (string, optional)
  • severity_filters (array, optional): 例: ["error", "warn"]。OR ロジック。
  • body_filters (array, optional): 例: ["timeout", "failed"]。OR ロジック。
  • start_time_iso / end_time_iso (string, optional)
  • index (string, optional)
  • response_mode (string, optional): summary (デフォルト。null の場合も同様) または raw。20行を超える場合、logs は get_logs と同じ summary に置き換えられ、その他のフィールドは保持されます。raw はエントリを返します。

複数のフィルタータイプは AND で結合されます。各配列内では OR が適用されます。 まず広範な集計件数には get_logs を使用します。get_service_logs は、サービス、環境、インデックスを絞り込み、サンプル数を少なくした後にのみ使用してください。

get_log_patterns

  • service_name (string, required)
  • env (string, optional)
  • start_time_iso / end_time_iso (string, optional)
  • lookback_minutes (integer, optional): デフォルト: 60。
  • severity_filters / body_filters (array, optional): get_service_logs と同様の OR ロジック。get_service_profile が severity_set all を報告する場合にのみ severity_filters を設定してください。none または partial を指定すると、本文に含まれる重大度のログ行が除外されます。
  • index (string, optional)
  • sample_size (integer, optional): ウィンドウからサンプリングするログ行数。新しい順。デフォルト: 1000、最大: 5000。
  • top_n (integer, optional): 件数別に返すテンプレート数。デフォルト: 20、最大: 100。残りは other に合算されます。

クラスタリングはサンプリングされたログ行に対して MCP サーバー上で実行されるため、件数、first_seen、last_seen はサンプル内の値です。window.sample_limit_reached は、サンプルが一致するログ行を見落とす可能性がある場合にその旨を示します (サンプルには sample_size 行が含まれ、API がそれと等しい正確な total_matching_lines を報告しない場合、または検索が logs_truncated だった場合)。その場合、サンプルにはウィンドウ内の最新のログ行のみが含まれます。各 template と sample は500文字で切り詰められ、末尾に … が付きます。そのため、クラスタリングされない本文 (たとえば message フィールドのない JSON) がレスポンスを埋め尽くすことはありません。チャンクの取得に失敗した検索はツールエラーになります。切り詰められた検索や上限に達した検索でもパターンは返され、sample_limit_reached で示されます。空の patterns リストが「一致なし」を意味するのは、sample_limit_reached が false の場合のみです。true の場合は検索が早期終了しており、一致するログ行を見落としている可能性があります。

get_emerging_log_patterns

すべての get_log_patterns パラメーターを受け取ります (時間範囲は現在のウィンドウです)。さらに次のパラメーターを指定できます。

  • baseline_start_time_iso / baseline_end_time_iso (string, optional): 両方を指定するか、どちらも指定しないでください。デフォルトでは、現在のウィンドウの直前にある同じ長さのウィンドウが使用されます。
  • min_count (integer, optional): 変化したパターンが、より多く出現する側のウィンドウで必要とするログ行数。new/increased の場合は現在のウィンドウ、decreased/disappeared の場合はベースラインです。デフォルト: 3 (それより小さい場合は sample_size)、最大: sample_size。
  • change_factor (number, optional): 1より大きい頻度比。両方のウィンドウで見られたパターンが到達する必要のある比率 (increased)、または低下する必要のある逆比 (decreased) です。デフォルト: 2。

両方のしきい値を満たす必要があるため、頻度が change_factor だけ変化していない大量のテンプレートは報告されません。変化したテンプレート (new、increased、decreased、disappeared) のみを返し、current と baseline の件数を含みます。unchanged_patterns は、両方のウィンドウに存在し、変化が change_factor 未満だったテンプレートの件数です。below_min_count_patterns は、ログ行数が min_count 未満だったため除外された変化の件数です。両方のサンプルに一致するすべてのログ行が含まれる場合、頻度は1分あたりで比較されます。上限に達したサンプルでは、正確な total_matching_lines から1分あたりの頻度を推定します。それ以外の場合はサンプル内の割合として比較されます。この場合、increased/decreased は発生率ではなく構成比を表します (comparison_basis)。空の patterns リストは、両方のしきい値を超える変化がなかったことを意味し、ログに変化がなかったことを意味するわけではありません。より小さな変化は below_min_count_patterns に集計されます。また、ウィンドウに sample_limit_reached がある場合、比較対象はウィンドウ全体ではなくサンプルです。

get_log_attributes

  • lookback_minutes (integer, optional): デフォルト: 15。
  • start_time_iso / end_time_iso (string, optional)
  • region (string, optional)
  • index (string, optional)

get_log_attributes_for_pipeline

  • pipeline (array, required): 検出範囲を絞り込むための先行フィルターステージ。例: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]。
  • lookback_minutes (integer, optional): デフォルト: 15。
  • start_time_iso / end_time_iso (string, optional)
  • region (string, optional)
  • index (string, optional)

get_drop_rules

パラメーターはありません。GET /otel_settings/drop?region=... を使用してドロップルールを一覧表示します。

add_drop_rule

  • name (string, required)
  • filters (array, required): 各フィルター: key、value、operator (equals/not_equals)、conjunction (and)。
  • フィルターキーには attributes["key_name"] または resource.attributes["key_name"] を使用する必要があります (Last9 API で必須)。
  • POST /otel_settings/drop?region=...&cluster_id=... を使用してルールを作成します。

get_remapping_rules

  • rule_type (string, required): logs_extract、logs_map、または traces_map。
  • region (string, optional): デフォルトでは、設定済みのデータソースリージョンが使用されます。
  • GET /otel_settings/remapping/{rule_type}?region=... を使用してルールを一覧表示します。

add_remapping_rule

呼び出しごとに1つのルールを作成します。マップルールでは、target_attribute ごとに1回呼び出す必要があります。

  • rule_type (string, 必須): logs_extract、logs_map、または traces_map。
  • name (string, 必須)
  • remap_keys (array, 必須): ソースフィールド。logs_extract と json の場合: body フィールド名。pattern の場合: 名前付きキャプチャグループを持つ正規表現を1つだけ指定します。マッピングルール: 属性パス。最初の空でない値が優先されます。
  • target_attribute (string, 必須): logs_extract: log_attributes または resource_attributes。logs_map: service、severity、または resource_deployment.environment。traces_map: service。
  • extract_type (string、logs_extract の場合のみ必須): json または pattern。
  • action (string、logs_extract の場合のみ): upsert (デフォルト) または insert。
  • prefix (string、logs_extract の場合のみ)
  • preconditions (array、logs_extract の場合のみ): {key, value, operator} は最大1つ。operator は equals (デフォルト)、not_equals、または like (正規表現)。
  • region (string、任意): デフォルト: 設定済みのデータソースリージョン。
  • POST /otel_settings/remapping/{rule_type}?region=... を使ってルールを作成します。再試行は行われません。タイムアウト後は get_remapping_rules で確認してください。

get_traces

広範な検索や集計に使用します。トレース ID を正確に検索するには、get_service_traces を使用してください。

  • tracejson_query (array、必須)
  • start_time_iso / end_time_iso (string、任意)
  • lookback_minutes (integer、任意): デフォルト: 60。
  • limit (integer、任意): デフォルト: 5000。

get_service_traces

trace_id または service_name のいずれか一方だけが必須です。

  • trace_id (string、任意): デフォルトの遡及期間: 72時間。
  • service_name (string、任意): デフォルトの遡及期間: 60分。
  • lookback_minutes (integer、任意)
  • start_time_iso / end_time_iso (string、任意)
  • limit (integer、任意): デフォルト: 10。
  • env (string、任意)

get_trace_attributes

  • lookback_minutes (integer、任意): デフォルト: 15。
  • start_time_iso / end_time_iso (string、任意)
  • region (string、任意)

get_trace_attributes_for_pipeline

  • pipeline (array、必須): 検出範囲を絞り込むための先行フィルターステージ。例: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]。
  • lookback_minutes (integer、任意): デフォルト: 15。
  • start_time_iso / end_time_iso (string、任意)
  • region (string、任意)

get_trace_attribute_values

  • tag_name (string、必須): get_trace_attributes の属性名 (例: resource_department または attributes['http.method'])。
  • pipeline (array、任意): 値の範囲を絞り込むための先行フィルターステージ。全体の値を取得する場合は省略します。
  • lookback_minutes (integer、任意): デフォルト: 15。
  • start_time_iso / end_time_iso (string、任意): 履歴の RFC3339 境界。lookback_minutes より優先されます。
  • region (string、任意)

get_trace_attribute_deviations

  • comparison_mode (string、必須): latency、errors、または time。
  • service_name (string、必須)
  • environment (string、必須): 正確な deployment.environment 値。
  • operation (string、任意)
  • filters (array、任意): トレース JSON フィルター条件。
  • candidate_attributes (array、任意): 最大8個。範囲を限定した検出では省略します。
  • latency_threshold_ms (number、任意): latency モードでは必須。他のモードでは拒否されます。
  • start_time_iso / end_time_iso (string、任意)
  • lookback_minutes (integer、任意): デフォルト: 15。最大: 15。
  • baseline_start_time_iso / baseline_end_time_iso (string、任意): time モードでは必須。重複せず、対象ウィンドウと同じ長さである必要があります。
  • minimum_cohort_size (integer、任意): デフォルト: 100。最小: 20。
  • minimum_value_support (integer、任意): デフォルト: 20。最小: 10。
  • limit (integer、任意): デフォルト: 10。最大: 10。

コンパニオンバックエンド機能を有効にする必要があります。

get_trace_waterfall

  • trace_id (string、必須)
  • environment (string、任意)
  • start_time_iso / end_time_iso (string、任意)
  • lookback_minutes (integer、任意): デフォルト: 4320 (72時間)。
  • selected_span_id (string、任意): そのスパンの属性、イベント、リンクのみを返します。
  • max_spans (integer、任意): デフォルト: 500。最大: 1000。組織の秘匿化ポリシーにより、上限がさらに低くなる場合があります。

トレースサービスの investigation-evidence/v1 エンベロープを変更せずに返します。ウォーターフォールは data の下にあります。サービスはウォーターフォールを生成し、バックエンドから送信する前に組織ごとのポリシーに従って値 (認証情報、クエリリテラル、URL、メールアドレス、IP、ユーザー識別子) を秘匿化します。sanitizer は適用されたポリシーを示し、evidence.sanitization は秘匿化または切り詰められた項目数を示します。必要な情報が秘匿化されている場合は、回避策を講じるのではなく、組織管理者にポリシーの調整を依頼してください。このツールは、sanitizer ブロックがない応答、trace-evidence-sanitizer/v1 以外の sanitizer.version、JSON キーが重複する本文、または 512 KiB を超える本文 (より低い上限は max_spans) を拒否します。コンパニオンバックエンド機能を有効にする必要があります。

get_change_events

  • start_time_iso / end_time_iso (string、任意)
  • lookback_minutes (integer、任意): デフォルト: 60。
  • service_name (string、任意)
  • env (string、任意)
  • event_name (string、任意): まずこれを指定せずに呼び出すと、available_event_names を取得できます。

analyze_change_impact

change_event または service + timestamp のいずれか一方だけを渡してください。

  • change_event (object、任意): get_change_events change_events[] の要素を1つ、そのまま指定します。metric.service、metric.deployment_environment、および最も早い values[].timestamp を使用します。
  • service (string、任意): change_event を省略する場合、timestamp とともに必須です。
  • timestamp (string、任意): RFC3339 または Unix 秒。分単位で切り捨てられます。
  • env (string、任意): 完全一致の環境。デフォルト: イベントの環境。イベントに環境がなければすべて。
  • baseline_minutes (integer、任意): デフォルト: 60。30..120 に制限されます。
  • after_minutes (integer、任意): デフォルト: baseline_minutes。30..120 に制限され、現在時刻が上限になります。

次のいずれかに該当する場合、regression likely となります。サービスまたはスループットで順位付けした上位10件の呼び出し元のいずれかで、エラー率が1パーセントポイント以上上昇、p95 が40%以上上昇、またはスループット (rpm) が50%以上低下する (変更前に100件以上のリクエストがあり、スループットの場合は変更後にも100件以上ある場合に限る。p95 は latency_env のリクエストのみを対象とする)。変更後にアラートが発火し、変更後ウィンドウの終了時にも発火中である (アラートグループ名、または service、service_name、service.name ラベルのいずれかと大文字小文字を区別せずに照合し、それらがなければアノテーションと照合します。サマリーなどの自由記述テキストとは照合しません。env が指定されている場合、大文字小文字を区別せず、別の環境がラベル付けされたアラートは除外され、環境ラベルのないアラートは env_match: unlabelled として扱われます)。get_apm_service_deviations によるリグレッションがある。変更後ウィンドウが5分未満の場合 (変更が未来の場合を含む)、サービスのリクエスト数が少なすぎる場合、またはゴールデンシグナル、直接呼び出し元の検索、アラート、get_apm_service_deviations のいずれかが、全体として、または deviations.apm.unavailable に列挙されたクエリのいずれかで失敗した場合、insufficient data となります。証拠が不足していても no significant change にはなりません。リグレッションが見つかった場合は、失敗した項目が示されます。no significant change は有効な回答であり、失敗ではありません。トレース属性の偏差は env が設定されている場合にのみ実行され、変更前後それぞれ最大15分を対象とします。偏差は判定の説明には使われますが、判定自体は決定しません。そのため、実行を省略したり取得に失敗したりしても判定は変わりません。各リストは項目を10件保持し、破棄した件数を報告します。上流呼び出しが失敗した場合、error は該当セクションにのみ付与されます。ゴールデンシグナルのレイテンシは、両方のウィンドウで同じ環境から取得され、その環境は latency_env に示されます。env がない場合は、最も負荷の高い環境が使われます。ゴールデンシグナルのエラー率は 5xx と gRPC エラーをカウントします。deviations.apm はエラーステータスのスパンと 429 もカウントします。呼び出し元のシグナルはその呼び出し元自身のサーバースパンに基づくため、クライアントスパンしかない呼び出し元の rpm は 0 になります。

regressions には、regression likely の各トリガーにつき1つのエントリが reason の順序で並び、その他の判定では [] になります。各エントリには、service、role (changed または dependent)、env、metric (次のうちちょうど1つ: error_rate_pct、latency_p95_ms、throughput_rpm、alert、apm_deviation)、およびメトリクスの単位 (%、ms、rpm、または APM シグナル固有の値。alert の場合は null) での baseline/after が含まれます。alert の項目には rule_id と state が追加されます。これは、そのインスタンスを含む変更後ウィンドウ内の最新のアラートモニターのスライスにおける状態で、常に firing です。変更後に発火し、変更後ウィンドウの終了までに解決したアラートはリグレッションではないため、チケットは作成されません。アラートは alerts.started に残り、state を保持し、reason にカウントされます。env はメトリクスを測定した環境です。要求された env があればそれを使用します。なければ、エラー率とスループットはすべての環境を合算し (env: "")、p95 は最も負荷の高い環境を使用します (latency_env)。アラートは独自の環境ラベルを使用し、APM の偏差は独自の環境を使用します。すべてのリグレッションはサービス全体を対象とするため、エンドポイントを示すものはありません。

get_alert_groups

changeboard / ラベルカバレッジ監査向けの、設定済み Compass アラートグループの一覧です。ルールが0件のグループや、発火していないグループも含まれます。PromQL は返しません。

  • alert_group_name / alert_group_type / data_source_name (string、任意): 大文字小文字を区別しない部分文字列一致。
  • team / tier (string、任意): 設定済みメタデータとの大文字小文字を区別しない完全一致。
  • label_key + label_value (string、任意): 両方を設定する必要があります。1つの metadata.labels ペア (キーと値の両方) との大文字小文字を区別しない完全一致。

id、name、type、entity_class、team、tier、metadata.labels、およびルール数を含む、コンパクトな JSON {"count":N,"groups":[...]} を返します。空の team / labels は未設定を意味します。

get_alert_operations_summary

  • start_time_iso / end_time_iso (string、必須): RFC3339 形式の期間。最大31日。
  • timezone (string、任意): 日付境界に使用する IANA 名。デフォルト: UTC。
  • severities / services (array、任意): サマリーの対象を絞り込みます。
  • include_rules (boolean、任意): ルールごとの衛生状態も返します (fire_count による上位20件、フラッピング中およびルーティングされていないルール。API がルール一覧を上限で切り詰めた場合は truncated を含みます)。デフォルト: false。

alerts_raised、acknowledged、unacknowledged、current_backlog、delivered、notification_outcomes、top_rules、needs_attention、および coverage を含む JSON を返します。各メトリクスは {status, count?, reason?} です。partial の件数は期間の一部のみを対象としており、下限値ではありません。

get_alert_coverage

サービス、環境、1つのアラートグループ、またはスコープを指定しない場合は組織全体について、「何にアラートを設定していないか」を回答します。読み取り専用です。作成、変更、ミュート解除は行いません。investigate ツールセットでも提供されています。

  • service (string、任意): サービス名。
  • environment (string、任意): デプロイ環境 (例: prod)。
  • entity_id (string、任意): アラートグループ (エンティティ) の UUID。get_alert_groups が返す値です。
  • muted_days (integer、任意): 1~3650の整数日。デフォルト: 7。0 はデフォルトを意味します。この期間より長くミュートされているルールは、muted_too_long ギャップです。 値はトリミングされます。空白文字列は無視されます。ギャップの種類: uncovered_signal(latency、error_rate、throughput、または saturation に対する有効なルールがない。カバーする無効なルールを示す)、all_rules_disabled(すべてのルールが無効なアラートグループ)、no_notification_channel(その重大度のルールに対して、アラートグループがルーティングするチャネルがない)、muted_too_long(無期限、または muted_days を超えてミュートされている。muted_since はルールの最終更新日時で、無期限のミュートでは mute_until は省略される)。

コンパクトな JSON {scope, generated_at, complete, summary, counts, groups} を返します。groups には、存在する種類ごとに {kind, count, gaps, omitted} エントリが1つ含まれ、各種類につき最大10件のギャップが列挙されます(残りの件数は omitted に記録されます。確認するにはスコープを絞り込んでください)。各ギャップには suggested_tool(create_alert、create_alert_from_chart、attach_notification_channel、または patch_alert)と suggested_args が含まれます。ここには、そのツールが受け付ける入力のみが格納されます(patch_alert: entity_id、id、および is_disabled=false または mute_until=0;attach_notification_channel: alert_group_id と breach/threat の severity;create_alert: entity_id;create_alert_from_chart: service_name)。ギャップ自体の entity_id、rule_id、signal はその横に列挙されます。提案されたツールは、セッションで利用可能であり、ユーザーが確認した場合にのみ呼び出してください。complete が true になるのは、API がギャップなしを返し、すべての件数が 0 で、かつ少なくとも1つのアラートグループがスコープに一致する場合のみです(正確な service_name / env ラベルを get_alert_groups のリストと照合します)。一致するものがないスコープ、検索の失敗、または列挙されたギャップがないのに件数がある場合は完了ではなく、その理由は summary に示されます。

get_alert_config

  • search_term (string, optional): 名前、グループ、データソース、タグを対象とするフリーテキスト検索。
  • rule_name (string, optional)
  • severity (string, optional)
  • rule_type (string, optional): static または anomaly。
  • alert_group_name / alert_group_type / data_source_name (string, optional)
  • tags (array, optional): すべて一致する必要があります(AND ロジック)。

各ルールには Recent Evaluations が列挙されます。1分間隔のサンプルが5件、新しい順に並び、それぞれ終了時刻の UTC 分がラベル付けされています。モニターは最新の1分間を遅れて埋めるため、最新のサンプルは呼び出しの1~2分前に終了します。firing;ok = モニターがルールを発火していないと報告した状態(正常、解決済み、保留中、または空の状態。is_firing=0 として get_alert_rule_state に記録);unknown = ルールのモニター行がない状態(まだ評価されていないか、その分の検索に失敗しており、応答の先頭に記載)、または状態が firing、normal、resolved、pending、empty のいずれでもない行(例: no_data、silenced)。無効なルールには何も表示されません。有効なルールが25件を超えて一致する場合、すべてのルールについて履歴が省略され、その旨が応答に記載されます。

get_entity_kpis

読み取り専用です。alerts および investigate ツールセットで利用できます。1つのアラートグループに属するすべての KPI を列挙します。アラートルールでまだ使用されていない KPI も含まれます。返された ID を expression_args / indicators_used で使用してください。ID を推測してはいけません。

  • entity_id (string, required): アラートグループ/エンティティの UUID。get_alert_groups または get_alert_config から取得します。

名前順に並べた JSON {"entity_id","count","kpis":[{"id","name","description","query","unit"}]} を返します。unit は表示ラベルです。しきい値は生のクエリ値と比較されます。適合する KPI がない場合は、create_kpi で作成してください。空のグループの結果に create_kpi が含まれるのは、セッションがそれを提供する場合のみです。--read-only(--allow-write-tools=create_kpi を除く)または investigate ツールセットでは、KPI の作成には書き込み可能な alerts セッションが必要であると表示されます。

create_kpi

既存のアラートグループに KPI を作成します。alerts ツールセットでのみ利用できます。get_entity_kpis に必要なクエリを持つ KPI がない場合にのみ使用してください。まず prometheus_range_query でクエリがデータを返すことを確認してください。API が拒否するのは構文解析できないクエリのみであり、存在しないメトリクスに対する有効なクエリは保存されます。

  • entity_id (string, required): アラートグループ/エンティティの UUID。
  • name (string, required): アラートグループ内で一意である必要があります。同じ名前で2回目の作成を試みると、競合として拒否されます。
  • query (string, required): PromQL。ダッシュボードパネルにアラートを設定するには、get_dashboard からパネルの PromQL を取得します。
  • unit (string, required): クエリの生の値の単位。例: seconds、ms、percent、ratio、count、req/s。これはラベルにすぎず、値を変換しないため、しきい値は生の値と比較されます。
  • description (string, optional)
  • data_source_id (string, optional): デフォルトはアラートグループのデータソースです。

KPI を削除または編集する MCP ツールはありません(Last9 UI を使用してください)。そのため、作成前に名前、クエリ、単位を確認してください。1回だけ作成し、返された ID を expression_args / indicators_used に使用してください。名前が競合した場合は、get_entity_kpis から既存 KPI の ID を再利用してください。タイムアウトまたは接続エラーが発生した場合、作成が適用されたかどうかは不明です。再試行する前に、get_entity_kpis で名前を確認してください。{"id","name","query","unit"} を返します。

get_alerts

  • time_iso (string, optional): RFC3339 形式の評価時刻。
  • window (integer, optional): 秒単位の遡及期間。デフォルト: 900。範囲: 60–86400。
  • lookback_minutes (integer, optional): 範囲: 1–1440。

get_alert_rule_state

  • start_time (integer or string, required): 範囲の開始時刻(含む)。Unix エポック秒(1718000000)または RFC3339(2024-06-10T06:13:20Z)。エポックミリ秒、マイクロ秒、ナノ秒は秒に変換されます。2000-01-01 より前の値は拒否されます。
  • end_time (integer or string, required): 範囲の終了時刻(含む)。同じ形式を使用します。
  • step (integer, required): サンプル間の秒単位の解像度。サンプル数 ((end_time - start_time) / step + 1) は最大100件です。各サンプルは、そのタイムスタンプで終了する min(step, 3600) 秒間を対象とする上流呼び出し1回分です。サンプルは5件ずつ取得され、60秒を超える場合、ツールは再試行の案内とともにエラーを返します。
  • alert_group_id (string, optional): アラートグループ ID で絞り込みます。
  • rule_name (string, optional): ルール名に対する正規表現フィルター。
  • alert_group_name (string, optional): アラートグループ名に対する正規表現フィルター。
  • label_filters (string, optional): カンマ区切りの key=value ラベルフィルター。
  • state (string, optional): 状態で絞り込みます(例: firing)。

rule_id -> [{timestamp, is_firing}] の JSON マップを返します。上流の応答にルールが存在しないタイムスタンプは is_firing=0 として報告されます。これは「発火中として観測されなかった」という意味であり、正常状態が確認されたことを意味しません。

get_alert_hygiene

有効なアラートルールの読み取り専用監査です。何も変更しません。提案された修正はそれぞれ提案にすぎず、ユーザーが明示的に確認した場合にのみ、提供されていれば update_alert(調整)、patch_alert(is_disabled)、delete_alert、または attach_notification_channel を通じて適用されます。

  • window (string, optional): 7d または 30d。デフォルト: 7d。
  • limit (integer, optional): フラグが付いたルールの返却上限。問題の深刻な順。デフォルト: 20。範囲: 1–100。

ウィンドウの終了時刻は現在です。カテゴリ(1つのルールが複数に該当する場合があります): noisy(< 20% acked; with an unavailable ack_rate it is judged on fire rate alone and the reason says so; mute time is not reported), flapping (> が1日あたり4回のフラップで、1日あたり5回以上発火)、stale(ウィンドウより前に最後に発火し、ウィンドウ内に発火時刻がない。または、有効で設定済みのルールにウィンドウ内のエピソードがなく、ライフサイクル coverage が完了しており、API のリストが切り詰められていない)、unrouted(ウィンドウ内の発火がチャネルに到達せず、現在アラートグループにチャネルが関連付けられていない。関連付けを読み取れない場合、そのルールは代わりに unavailable.routed に分類されます)。各統計値は {status, count|value, reason} または null です。利用できない値をゼロとして扱うことはなく、その値を必要とするチェックのみがスキップされます。また、unavailable は値が欠落しているルールの件数を示します(fire_count、flap_count、ack_rate、routed、アラートルール一覧にないルールの rule_config。これらの修正には現在値が含まれません。また、エピソードがない設定済みルールの activity。履歴から沈黙を証明できないため、評価対象外です)。coverage は、アラート履歴がウィンドウのどの程度をカバーしているかを示します。レートには、少なくとも1日分のカバー範囲が使用されます。API が最も頻繁に発火する200件のルールのみを返した場合、upstream_truncated は true となり、発火頻度の低いルールは評価されません。修正案は、アラートルール一覧にある各ルールの設定に基づきます。bad_minutes を引き上げる(count_true(result) >= N の N)か、eval_window を延長する(最大60分)。ノイズの多い静的しきい値については、condition(expr > 100)でしきい値を変更するか、式を adaptive_std_cmp(metric, sensitivity, window) に切り替えます。通知チャネルを関連付けます。古いルールは無効化または削除します。

32 KB を目標にサイズを調整したコンパクトな JSON {window, from, to, coverage, upstream_truncated, rules_evaluated, flagged_rules, truncated, omitted_for_size, unavailable, rules} を返します。フラグ付きルールが limit またはその目標サイズを超える場合、truncated は true です。サイズ制限のために limit から除外されたルールの件数は omitted_for_size に記録されます(最も問題の深刻なルールは常に保持されるため、単一のルールが32 KBを超える場合はそのルールのみが返され、目標サイズを超過します)。各ルールには findings(category、reason、suggested_fix、任意の alternative_fix)と、生の stats が含まれます。

get_notification_channels

  • scope (string, optional): attached(デフォルト)は、アラートグループへの関連付けごとに1行を返します。id は関連付け ID で、detach_notification_channel が受け取る値です。channels は組織のチャネル(id、name、type、send_resolved、created_via)を返します。id はチャネル ID で、attach_notification_channel が受け取る値です。宛先、ヘッダー、証明書は返されません。

設定済みの通知チャネル(Slack、PagerDuty、メール、webhook など)を TSV テーブルとして返します。関連付け行(service_fqid が設定済み)では、global は false、services は - です。services はレガシーサービスのバインディングのみを列挙します。関連付け行の send_resolved は、その行に保存されたデフォルト値であり、配信に使用される値ではありません。解決通知は、チャネル独自の send_resolved(scope=channels)に従います。どちらのスコープにも created_via が含まれます(MCP エージェントが作成した行では last9-mcp、それ以外では -)。

recommend_alert_config

読み取り専用です。ライフサイクルに関するガイダンス、検証ゲート、対応者コンテキストの要件を返します。これ自体は根拠ではないため、しきい値はテレメトリツールで裏付けてください。

  • signal (string, required): 単位とディメンションを含むメトリクスまたはユーザー影響のシグナル。
  • objective (string, required): 検出する症状またはユーザー影響。
  • rule_type (string, optional): static(デフォルト)または anomaly。
  • severity (string, optional): breach(デフォルト)または threat。
  • environment (string, optional): 環境とトラフィックのプロファイル。

validate_alert_expression

式を保存せずにドライランします。create_alert / update_alert の前に使用してください。

  • entity_id (string, required): アラートグループ/エンティティの UUID。
  • expression (string, required): KPI の正確な名前で指定したインジケーターを使う算術式。例: errors / requests。インジケーターは最大3つです。スペース、ドット、ダッシュを含む名前はそのまま記述してください(Test Alert / errors)。create_alert が保存する名前と完全に一致させてください。
  • indicators_used (object, required, non-empty): インジケーター名から、entity_id が所有する KPI UUID への対応付け。get_entity_kpis でグループの KPI ID と名前を列挙してください。各 KPI の正確な名前を使用してください。このドライランでは任意の名前を受け付けますが、create_alert と update_alert は、バインドされた KPI の名前と一致しない expression_args キーを拒否します。 算術式のみが検証されます(adaptive_std_cmp(...) のラッパーではなく、内側のメトリクス式を渡してください)。condition / alert_condition は検証されません。1つ以上の時系列があるかどうかのチェックは、インジケーターが複数使用されている場合にのみ実行されます。

{"valid":true} または {"valid":false,"reason":"..."} を返します。無効な式は通常の結果であり、ツールエラーではありません。

describe_alert_chart

読み取り専用です。対象の Discover チャート上でアラート可能なシグナル(key、unit、eval_query、query_kind)を一覧表示します。Viewer ロールのトークンは拒否されます。

  • surface (string, required): discover-service または discover-exceptions。カスタムダッシュボードを含むその他のサーフェスは、API 呼び出し前に拒否されます(代わりに KPI を指定して create_alert を使用してください)。
  • chart_key (string, required): 例: apdex、error_rate、response_time、exception_count。
  • service_name (string, required)
  • env (string, optional)
  • attributes (object, optional): このツールが報告するキー名を使用した追加の識別ディメンション。

create_alert

既存のアラートグループにルールを作成します。常に無効状態で作成されます(is_disabled=false が渡された場合も下書きです)。最初に recommend_alert_config を呼び出し、ユーザーの確認後にのみ patch_alert is_disabled=false で有効化してください。一度だけ作成し、返されたルール ID を保持してください。アラートグループですでに使用されている rule_name(大文字と小文字を区別しない)は拒否され、既存ルールの ID が示されます。

  • entity_id (string, required): アラートグループ/エンティティの UUID。
  • alert_rule (object, required): primary_indicator と expression_args を含む、完全な型付きルール本文。これらはエンティティの実在する KPI にバインドされている必要があります。各 expression_args キーは、バインド先 KPI の正確な名前でなければなりません(x のようなプレースホルダーは不可)。また、primary_indicator と expression ではその名前を使用します。静的ルールでは condition、alert_condition、eval_window(0~60 分)が必要です。適応型ルールでは expression = adaptive_std_cmp(<primary_indicator>, sensitivity, window) を使用します。この場合、3つのフィールドは省略可能です(デフォルトは expr > 0、count_true(result) >= 1、1)。algorithm は設定できません。レスポンダーのコンテキストは properties(説明、ランブック、注釈、query_mode)に指定します。

通知のルーティングはルールではなく、アラートグループで設定します。

create_alert_from_chart

describe_alert_chart で説明されたチャートから、静的しきい値ルールを作成します。create_alert と同様に、ルールは無効な下書きとして作成され、発火しません。ユーザーの確認後にのみ patch_alert is_disabled=false で有効化してください。チャート API はルールを有効状態で作成するため、このツールは作成直後にルールを無効化します。これに失敗した場合、ルール ID を示すエラーが返されます。そのルールは有効な状態の可能性があります。

  • surface / chart_key / service_name / signal_key / name (string, required)
  • env (string, optional)
  • attributes (object, optional)
  • threshold (number, optional): シグナルの単位で指定します。0 以上である必要があります。apdex などのスコア単位のシグナルでは、明示的な値が必要です。
  • threshold_operator (string, optional): >(デフォルト)、<、>=、<=、==、!=。
  • eval_window (integer, optional): 分単位、1~60。デフォルト: 5。
  • bad_minutes (integer, optional): 1~eval_window。デフォルト: 3。
  • severity (string, optional): breach または threat。
  • description (string, optional)
  • group_id (string, optional): 通常は省略します。

update_alert

ルールの評価設定を完全に置き換えます。最初に get_alert_config または get_entity_alert_rules でルールを取得してください。ルールが存在しない場合、または別のアラートグループに属している場合は、何も変更せずに拒否されます。ルールがソフト削除されて再作成される場合があるため、その後は返された置換後の ID を使用してください。

  • entity_id (string, required)
  • id (string, required): アラートルールの UUID。
  • alert_rule (object, required): 完全な設定。create_alert と同じ形式です。

patch_alert

ルール ID を維持したまま部分的に変更します。少なくとも1つの変更が必要です。ルールが存在しない場合、または別のアラートグループに属している場合は、何も変更せずに拒否されます。

  • entity_id (string, required)
  • id (string, required): アラートルールの UUID。
  • is_disabled (boolean, optional): false は有効化、true は一時停止します。
  • mute_until (integer, optional): Unix エポックの期限。0 はミュートを解除します。
  • properties (object, optional): description、runbook、annotations、query_mode。送信した各フィールドは保存済みの値を置き換えます。省略または空欄のフィールドは保存済みの値を維持します。annotations はマップ全体を置き換えるため、維持するキーはすべて送信してください。{} はマップをクリアします。
  • recurring_mute_schedule (object, optional): 週間スケジュールを置き換えます: enabled(デフォルトは false)、timezone(IANA 名、必須)、および windows(weekdays のうち1~20個を sun..sat、start_time / end_time の形式で24時間表記の HH:MM として指定)。終了時刻が開始時刻以前の場合、終了は翌日になります。維持するウィンドウはすべて送信してください。
  • clear_recurring_mute_schedule (boolean, optional): スケジュール全体を削除します。recurring_mute_schedule とは併用できません。ウィンドウを保存したままにする enabled=false とは異なります。

Viewer ロールのユーザーが変更できるのは mute_until のみです。グループまたはエンティティがミュートされている間は、ルール単位のミュート変更は拒否されます。get_entity_alert_rules で変更内容を読み戻すと、mute_until、recurring_mute_schedule、properties が表示されます。

delete_alert

ルールを完全に削除します。get_alert_config で確認し、必ず事前にユーザーから明示的な確認を得てください。ルールが存在しない場合、または別のアラートグループに属している場合は、何も削除せずに拒否されます。

  • entity_id (string, required)
  • id (string, required): アラートルールの UUID。

mute_alert_group

グループ内の現在および将来のすべてのルールをミュートします。1つのルールだけをミュートするには、mute_until を指定して patch_alert を使用してください。編集者アクセスが必要です。

  • entity_id (string, required): アラートグループ/エンティティの UUID。
  • until (integer, required): ミュートが終了する Unix エポック秒。0 はミュートを解除します。-1 のような負の値を指定すると、無期限にミュートします。

acknowledge_alert

発火中のアラートの担当者になり、または担当を解除します。アラートの解決やミュートは行いません。すでに自分が担当しているアラートを確認しても、安全な no-op です。ack は、直近1時間以内に get_alerts がそのアラート(3つすべての ID が一致)を列挙していない限り、何も記録せずに拒否されます。

  • alert_group_id / rule_id / rule_type (string, required): get_alerts のアラートからコピーしてください。
  • action (string, optional): ack(デフォルト)または unack。確認を解除できるのは担当者または組織管理者のみです。
  • mute_until (integer, optional): ack の場合のみ。mute_alert_group または patch_alert で適用済みのミュートを記録します。ミュート自体は行いません。

reassign_alert

すでに担当者がいるアラートを別のユーザーに引き継ぎます。担当者がいない場合は、先に確認してください。アラートに担当者がいないため再割り当てが行われなかった場合、直近1時間以内に get_alerts がそのアラートを列挙しているかどうかを示します。Last9 は新しい担当者に通知しません。

  • alert_group_id / rule_id / rule_type (string, required): get_alerts のアラートからコピーしてください。
  • owner_email (string, optional): 優先して使用されます。有効な組織ユーザーと大文字・小文字を区別せず照合されます。
  • owner_user_id (string, optional): owner_email または owner_user_id のいずれか一方を正確に指定してください。

create_notification_channel

チャネルを作成します。attach_notification_channel でアラートグループに関連付けるまでは、何もルーティングされません。一度だけ作成し、ID を保持してください。更新用のツールはありません。返されるのは id、name、type、send_resolved のみです。

  • name (string, required): 種類ごとに一意である必要があります。コロンは使用できません。
  • type (string, required): slack、pagerduty、opsgenie、email、または generic_webhook。
  • destination (string, required): Slack Incoming Webhook URL(または slack_app_mode を使用したチャネル ID)、PagerDuty ルーティングキー、Opsgenie API キー、任意のドメインの業務用メールアドレス(カンマ区切り。組織のドメインに限定されません。API は Gmail などの個人向けプロバイダーのアドレスを拒否し、個人用ログインで作成された組織では管理者のアドレスのみ受け付けます)、または HTTPS webhook URL。
  • slack_app_mode (boolean, optional): Slack のみ。デフォルト: false。
  • mention_handles (string, optional): カンマ区切り。例: user|U123ABC|name、special|here、special|channel。
  • webhook_headers (object, optional): generic_webhook のみ。
  • webhook_ca_certificate (string, optional): generic_webhook のみ。最大64 KiB の PEM CA 証明書を1つ指定します。
  • send_resolved (boolean, optional): デフォルト: true。

attach_notification_channel

既存のチャネルを1つのアラートグループにルーティングします。冪等です。関連付け時に、チャネルの配信設定(ヘッダー、証明書、メンション)がコピーされます。後からチャネルの設定を変更した場合は、再度関連付けてください。

  • channel_id (integer, required): チャネル ID(scope=channels を指定して get_notification_channels で取得したもの)であり、関連付け ID ではありません。
  • alert_group_id (string, required): get_alert_groups から取得します。
  • severity (string, required): breach、threat、または both。both は2つの関連付けを作成します。2つ目が失敗した場合、1つ目は関連付けられたままになり、エラーには再試行する重大度が示されます。

detach_notification_channel

1つの関連付けを削除します。削除スコープのトークンが必要です。書き込みスコープのトークンでは関連付けを解除できません。

  • attachment_id (integer, required): scope=attached を指定して get_notification_channels から取得した id。チャネル ID は拒否されます。
  • alert_group_id (string, optional): 関連付けが別のグループに属している場合は拒否されます。

delete_notification_channel

関連付けのないチャネルを完全に削除します。先に関連付けを解除してください。削除スコープのトークンが必要です。チャネルを再一覧表示して削除を確認します。

  • channel_id (integer, required): scope=channels を指定して get_notification_channels から取得した id。関連付け ID は拒否されます。

did_you_mean

  • query (string, required): 検索する名前。部分一致、誤記、略称を指定できます。
  • type (string, optional): エンティティの種類で絞り込みます: service、environment、host、database、k8s_deployment、k8s_namespace、job。

類似度スコア付きで、最も近い候補を最大3件返します。エンティティ名が不確かな場合は、ツールを呼び出す前に使用してください。前回の呼び出しで結果が空だった場合は、再試行する前にこのツールを試してください。

get_service_profile

  • service_name (string, required): テレメトリプロファイルを導出するサービス。
  • datasource (string, optional): データソース名。デフォルトを使用する場合は省略してください。おおよその名前は Prometheus ツールと同様に解決されます。 短い調査概要に続けて、完全なプロファイルを未加工の JSON として返します。シグナルの有無(logs/traces/metrics は present、absent、または unknown)、言語とランタイム、デプロイ環境、ログの signal_shape(log_format、severity_set、level_field、trace_context_in_logs)、および該当する場合は推奨される取り込み修正が含まれます。バックエンドが freshness を報告した場合、概要には freshness.logs.last_seen と freshness.traces.last_seen を含む last seen 行(RFC3339、null の場合は none)と、freshness.traces_stale が true の場合の traces stale 警告が追加されます。これは、ログが継続する一方でスパンが停止したことを示すため、設定不足ではなく freshness.traces.last_seen 周辺のリグレッションを調査してください。上流から導出され、約15分の TTL でキャッシュされます。

サービスを対象とする調査を始める前に呼び出し、ツールの選択をサービスの実際のテレメトリに合わせてください。traces が absent の場合はトレースツールを省略し、severity_set が none または partial の場合は、severity_filters を使わず、ログ本文の level_field から重大度を解析してください。metrics は常に unknown であり、v1 では dependencies は設定されません。logs と traces が両方とも absent の場合、サービスが監視されていないと結論づける前に、did_you_mean で名前を確認してください。

list_dashboards

  • name (string, optional): ダッシュボード名の大文字小文字を区別しない部分文字列。リストを絞り込み、total。
  • limit (integer, optional): 1ページあたりのダッシュボード数(1~200)。デフォルト: 100。
  • cursor (string, optional): 前のページの next_cursor。同じ name とともに渡します。

{"dashboards": [{"id", "name", "updated_at", "created_by", "locked"}], "total", "next_cursor"} を返します。更新日時の新しい順です。空の場合、created_by は省略されます。API が readonly を報告しない場合、locked は省略されます。updated_at は文字列形式の Unix エポック秒です。32 KB 未満に収めるため、ページが早めに終了することがあります。最後のページでは next_cursor はありません。

get_dashboard

  • id (string, required): ダッシュボード UUID。
  • region (string, optional): パネルクエリの生成に使うリージョン。デフォルトは設定済みのデータソースリージョンです。

結果にはトップレベルの locked(API が省略した場合は false)と、created_by(作成者のユーザー ID)が追加されます。

パネルにアラートを設定する方法については、last9://reference/alerting を参照してください。

validate_dashboard

読み取り専用です。ダッシュボードの作成や更新は行いません。dashboard_id または dashboard_definition のいずれか一方だけを指定してください。

  • dashboard_id (string, optional): 検証する保存済みダッシュボード UUID。
  • dashboard_definition (object, optional): インラインの未保存ダッシュボード本文(完全なドライラン)。{dashboard, metadata} の作成エンベロープは、その dashboard オブジェクトに展開されます。
  • start_time_iso / end_time_iso (string, optional): 検証期間(RFC3339)。24時間以下である必要があります。
  • region (string, optional): パネルクエリの実行に使うリージョン。

dashboard_validation/v1 を返します。パネルごとの lint と実行分類(data / no_data / invalid / error)が含まれます。Day-1 の空の結果は、診断プローブなしで valid_no_data に分類されます。パネルのないダッシュボードは、error: "no_panels" を伴う success: false を返します。他の形式のパネルフィールド(Grafana の gridPos、title、type、およびクエリが必要なパネルの targets)と、型の誤ったフィールドは、パネルごとに shape_problems に列挙され、summary.panels_invalid_shape に集計されます。また、overall は fail になります。

preview_dashboard

読み取り専用のクライアント側プレビューです。dashboard(作成リクエストの未保存ダッシュボードオブジェクト)、または id と ops(patch_dashboard と同じ順序の操作)を渡します。必須の start_time_iso と end_time_iso は RFC3339 タイムスタンプで、期間は最大24時間です。任意の variables にはスカラー値の上書きを指定できます。指定しない場合は、ダッシュボードの値と組み込みのデフォルトが適用されます。

{
  "id": "dashboard-id",
  "ops": [{"op": "update_panel", "panel_id": "panel-id", "fields": {"name": "Request latency"}}],
  "start_time_iso": "2026-10-01T08:00:00Z",
  "end_time_iso": "2026-10-01T09:00:00Z"
}

saved: false、定義/クエリの validation 概要(作成スキーマとの不一致がある場合は definition_error を含む)、および ok / empty / error のステータス、解決済みクエリ、ターゲット診断を含む panels を返します。PromQL と LogJSON は実行されます。未対応のクエリタイプと解決できない変数がある場合、パネルはエラーになります。有効な非クエリパネルは ok、無効なパネル定義は error です。パッチの diff には、正味の panels_added、panels_changed(移動を含む)、panels_removed と、順序付きの操作変更が含まれます。パネルの識別には ID と0始まりのインデックスを使います。削除されたインデックスは元のダッシュボードを参照します。保存するパネルの ID は空でなく、重複していない必要があります。

上限: パネル50件、クエリ100件、操作100件、入力と候補ダッシュボードそれぞれの JSON サイズ65,536バイト、実行期限60秒。解決済みクエリが65,536 JSON バイトを超える場合、実行前に拒否されます。証拠データはターゲットごとに最大3件のサンプル、1,024 JSON バイトまで保持されます。サンプルが省略された場合は truncated: true が付与されます。JSON レポートが262,144バイトを超えると、入力を減らすよう案内して失敗します。

ダッシュボードは作成も更新もされません。候補を作成スキーマに照らして確認し、既存のバリデーターを使ってクエリを実行しますが、バックエンドでの受け入れやレンダリングを保証するものではありません。バックエンドが割り当てる ID、デフォルト値、破棄されたフィールド、同時編集によって、保存結果が変わることがあります。プレビューでは、書き込み時と同じローカルパッチ操作とパネルバージョンのデフォルトが使われます。

create_dashboard

新規作成専用です。この呼び出しが dashboard.id を返した後は、パネルの編集に patch_dashboard(または構成変更に update_dashboard)を使ってください。パネルの追加、削減、修正のために再作成しないでください。

  • dashboard (object, required): name と panels[] を含むダッシュボード定義。各パネルには name、version、layout(x、y、w、h)、visualization.type、queries[] が必要です。
  • metadata (object, optional): ダッシュボードのメタデータ — _category と _type のフィールド(例: {"_category":"custom","_type":"metrics"})。

update_dashboard

ダッシュボードの大部分を再構成する場合にのみ使用してください。個々のパネルの追加、編集、削除、移動には patch_dashboard を使います。ID による完全置換(create と同じ本文)では、すべてのパネルを正確に再送する必要があります。

  • id (string, required): 更新するダッシュボード UUID。
  • dashboard (object, required): ダッシュボード本文全体の置換(create と同じ形式)。
  • metadata (object, optional): 置換するメタデータ。読み取り専用のシステムダッシュボードでは、復旧可能なツールエラーが返されます。

patch_dashboard

小規模な調整には update_dashboard よりこちらを優先してください。変更のないパネルは再送されません。ダッシュボードを読み取り、ops を順に適用して書き戻すため、読み取りと書き込みの間に別の場所で行われた編集は上書きされます。{dashboard_id, changes[]} を返します。ダッシュボードがすでに満たしている操作は除外され、何も変更されない場合は書き込みも行われません。書き込み後に再読み込みした内容と差分を照合します。パネルの fields には保存された値が表示され、not_stored には API が破棄したキー、not_removed には null にもかかわらず API が保持したキーが列挙されます。200文字を超える差分値は、JSON 型を保ったままその場で短縮されます。

  • id (string, required): パッチを適用するダッシュボード UUID。
  • ops (array, required): 順に適用する操作。いずれかが無効な場合は何も書き込まれず、エラーでは該当操作が ops[i] として示されます。
    • add_panel: panel(パネルオブジェクト全体。version のデフォルトは1)、任意の index(0始まりの挿入位置。デフォルトは末尾)。
    • update_panel: panel_id、fields(置換するパネルのトップレベルキー。null はキーを削除し、id は変更できません)。
    • remove_panel: panel_id。
    • move_panel: panel_id、index(移動後の0始まりの位置)。
    • set_title: title(ダッシュボード名)。
    • set_variable: variable。同じ target を持つ変数を置き換え、それ以外の場合は末尾に追加します。

delete_dashboard

  • id (string, required): 削除するダッシュボード UUID。読み取り専用のシステムダッシュボードは削除できません。

set_dashboard_lock

  • id (string, required): ダッシュボード UUID。
  • locked (boolean, required): true はダッシュボードをロックし、false はロックを解除します。

書き込みツールです。ユーザーが明示的に依頼した場合にのみ呼び出してください。ロックまたはロック解除できるのはダッシュボードの作成者または組織管理者だけです。組み込みダッシュボードは常に読み取り専用です。結果の状態を含む {"id", "locked"} を返します。ロック中は、update_dashboard、patch_dashboard、delete_dashboard は書き込みを行わず、作成者を示し、ロック解除または create_dashboard によるダッシュボードのコピーを提案する、dashboard is locked で始まる復旧可能なツールエラーを返します。

list_dashboard_snapshots

  • dashboard_id (string, required): スナップショットを一覧表示するダッシュボード UUID。

メタデータのみ(id、name、expires_at など)を返します。固定されたパネルデータには get_dashboard_snapshot を使ってください。

get_dashboard_snapshot

  • id (string, required): スナップショット UUID。

dashboard_definition、panel_data、time_range、variables を含む、固定されたスナップショット全体を返します。

delete_dashboard_snapshot

  • id (string, required): 削除するスナップショット UUID。

get_profile_services

  • lookback_minutes / start_time_iso / end_time_iso (optional): 期間。lookback または明示的な ISO 境界を推奨します(デフォルトは60m)。
  • region (string, optional): リージョンの上書き。

指定期間にプロファイリングデータがあるサービスを返します。get_flamegraph / get_top_functions / get_profile_summary の前に呼び出してください。

get_flamegraph

  • service (string, required): get_profile_services から取得したサービス名。
  • profile_type (string, optional): cpu(デフォルト)、alloc、または wall。期間を比較する場合はタイプを固定してください。
  • env / cluster / namespace / runtime (string, optional): スコープフィルター。
  • limit (number, optional): 集約スタック行の最大数(デフォルト1000、最大10000)。
  • lookback_minutes / start_time_iso / end_time_iso / region (optional)。

ネストされたフレームグラフツリー(name / value / self / children)を返します。truncated: true は API の行数上限に達したことを示します。

get_top_functions

get_flamegraph と同じフィルターを使います。自己サンプルに基づく、処理時間の長い関数のランキングを返します。切り詰められる場合があるため、truncated を確認してください。

get_profile_summary

get_flamegraph と同じフィルターを使います。サービスのプロファイルを短い自然言語でトリアージした結果を返します。

grafana_search_dashboards

  • query (string, optional): タイトルの部分文字列。空の場合は広範囲に一覧表示します(上限5,000行)。

{"dashboards":[…], "truncated":bool} を返します。uid、title、uri、url、type、tags が含まれます。grafana_get_dashboard とともに uid を使ってください。

grafana_get_dashboard

  • uid (string, required): Grafana ダッシュボードの uid。
  • full_json (boolean, optional): true の場合、フィルター済みの概要ではなく、Grafana の未加工 JSON を返します。

デフォルトの概要には、バージョン、タグ、テンプレート変数、および各パネルのタイプ/データソース/gridPos/PromQL ターゲットが含まれます。不明なプラグインのパネルタイプは unsupportedPanelTypes に表示されます。

grafana_list_folders

パラメーターはありません。フォルダツリーを返します。

grafana_list_folder_dashboards

  • folder_uid (string, required): Grafana フォルダーの uid。

そのフォルダー内のダッシュボードについて {"dashboards":[…], "truncated":bool} を返します(最大 5,000 件までページネーション)。

grafana_list_datasources

パラメーターはありません。データソースの安全な投影を返します(認証情報フィールドは含まれません)。


テスト

アプリケーションのテストを実行せずに、テスト goroutine アナライザーを実行します。

make lint-test

これは、すべてのパッケージ(各パッケージの *_test.go ファイルを含む)に対して Go の testinggoroutine アナライザーを実行し、安全でないフィクスチャと安全なフィクスチャを使って検証します。CI の両方のテストワークフローでは、キャッシュされたパッケージテストの結果によって lint の適用が回避されないよう、go vet -testinggoroutine ./... を独立したステップとして実行します。

ルートパッケージでも、テストとしてアナライザーを実行します。このチェックをキャッシュなしで含めて全スイートを実行するには go test -count=1 ./... を使用してください。Go のテストキャッシュは、アナライザーのサブプロセスが読み込む内部パッケージのソースファイルを追跡しません。通常の go test ./... では、これらのファイルが変更された後も、ルートテストの成功結果が再利用されることがあります。

testing.T 上の testing.B で実行される Fatal、Fatalf、および FailNow は、親テスト goroutine で実行する必要があります。ワーカーから親にエラーを返し、親側でアサーションしてください。

errs := make(chan error, 1)
go func() { errs <- doWork() }()
if err := <-errs; err != nil {
    t.Fatal(err)
}

このアナライザーは、go func クロージャー内の直接呼び出しを検出します。任意のヘルパー呼び出しの背後に隠されたアサーションを対象とする、一般的なプロシージャ間チェックではありません。統合テストは、TEST_REFRESH_TOKEN が設定されていない場合はスキップされます。


MseeP.ai Security Assessment Badge