MCP Tools Reference: clouderrorreporting.googleapis.com

ツール: list_group_stats

このツールは、アプリケーションで繰り返し発生するスタック トレースを検出して分析する場合にのみ使用してください。類似したスタック トレースを集計し、発生回数や影響を受けたユーザー数などの統計情報を提供します。このツールは、一般的なエラーの検索や個々のエラーログの表示には使用しないでください。「エラーを見つけて」または「エラーを表示して」というクエリの場合は、list_log_entries ツールを使用する必要があります。重要: エラーに関する一般的な質問については、他のツールをデフォルトで使用します。

次のサンプルは、curl を使用して list_group_stats MCP ツールを呼び出す方法を示しています。

Curl リクエスト 
                  
curl --location 'https://clouderrorreporting.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_group_stats",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

返す ErrorGroupStats のセットを指定します。

次の ID: 19

ListGroupStatsRequest

JSON 表現 
{
  "projectName": string,
  "groupId": [
    string
  ],
  "serviceFilter": {
    object (ServiceContextFilter)
  },
  "timeRange": {
    object (QueryTimeRange)
  },
  "timedCountDuration": string,
  "alignment": enum (TimedCountAlignment),
  "alignmentTime": string,
  "order": enum (ErrorGroupOrder),
  "pageSize": integer,
  "pageToken": string
}
フィールド
projectName

string

必須。Google Cloud Platform プロジェクトのリソース名。projects/{projectID} または projects/{projectNumber} として記述します。{projectID} と {projectNumber} は Google Cloud コンソールで確認できます。projects/{projectID}/locations/{location}（{location} はクラウド リージョン）などのロケーションも含まれる場合があります。

例: projects/my-project-123、projects/5551234、projects/my-project-123/locations/us-central1、projects/5551234/locations/us-central1。

サポートされているロケーションの一覧については、サポートされているリージョンをご覧ください。指定しない場合、デフォルトは global です。- をワイルドカードとして使用して、すべてのリージョンからグループ統計情報をリクエストします。
groupId[]

string

省略可。これらの ID を持つすべての ErrorGroupStats を一覧表示します。group_id は、特定のエラー グループの一意の識別子です。この識別子はエラーログの内容の重要な部分から導き出され、サービスデータとして扱われます。サービスデータの取り扱いについては、Google Cloud のプライバシーに関するお知らせをご覧ください。
serviceFilter

object (ServiceContextFilter)

省略可。フィルタに一致するサービス コンテキストに属する ErrorGroupStats のみを一覧表示します。このフィールドを指定しないと、すべてのサービス コンテキストのためのデータが返されます。
timeRange

object (QueryTimeRange)

省略可。指定された期間のデータを一覧表示します。設定されていない場合は、デフォルトの時間範囲が使用されます。レスポンスの time_range_begin フィールドには、この期間の開始時点が指定されます。リクエストに明示的な group_id リストが含まれていない限り、指定された期間にカウントがゼロ以外の ErrorGroupStats のみが返されます。group_id リストが指定されている場合は、出現回数がゼロの ErrorGroupStats も返されます。
timedCountDuration

string (Duration format)

省略可。返される 1 つの TimedCount の推奨期間。設定しない場合、時限カウントが返されません。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
alignment

enum (TimedCountAlignment)

省略可。返される時間指定カウントの配置。デフォルトは、ALIGNMENT_EQUAL_AT_END です。
alignmentTime

string (Timestamp format)

省略可。丸められた配置が選択されている場合、時間指定されたカウンタが配置される時間。デフォルトは 00:00 UTC です。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
order

enum (ErrorGroupOrder)

省略可。結果が返される並べ替え順序。デフォルトは、COUNT_DESC です。
pageSize

integer

省略可。レスポンスごとに返される結果の最大数。デフォルト値は 20 です。
pageToken

string

省略可。前のレスポンスで提供された next_page_token。追加の結果を表示するには、このトークンを最初のリクエストと同じクエリ パラメータとともに渡します。

ServiceContextFilter

JSON 表現 
{
  "service": string,
  "version": string,
  "resourceType": string
}
フィールド
service

string

省略可。ServiceContext.service と照合する正確な値。
version

string

省略可。ServiceContext.version と照合する正確な値。
resourceType

string

省略可。ServiceContext.resource_type と照合する正確な値。

QueryTimeRange

JSON 表現 
{
  "period": enum (Period)
}
フィールド
period

enum (Period)

クエリを指定した期間に制限します。

所要時間

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

期間の符号付き秒数。-315,576,000,000 ～+315,576,000,000 の範囲（両端を含む）にする必要があります。注: これらの境界は、60 秒/分 * 60 分/時間 * 24 時間/日 * 365.25 日/年 * 10,000 年から計算されます。
nanos

integer

期間のナノ秒分解能による、秒の符号付き小数以下部分。1 秒未満の期間は、0 の seconds フィールドと正または負の nanos フィールドで表されます。1 秒以上の期間の場合、nanos フィールドのゼロ以外の値は、seconds フィールドと同じ符号である必要があります。-999,999,999～+999,999,999 の範囲内（境界含む）である必要があります。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

出力スキーマ

要求されたエラーグループ統計のセットが含まれます。

ListGroupStatsResponse

JSON 表現 
{
  "errorGroupStats": [
    {
      object (ErrorGroupStats)
    }
  ],
  "nextPageToken": string,
  "timeRangeBegin": string
}
フィールド
errorGroupStats[]

object (ErrorGroupStats)

指定されたリクエストに一致するエラー グループの統計情報。
nextPageToken

string

空でない場合、さらに結果があります。最初の要求と同一のクエリ パラメータと一緒にこのトークンを渡して、結果の次のページを表示させます。
timeRangeBegin

string (Timestamp format)

タイムスタンプは、リクエストが制限された開始時刻を指定します。開始時間は、リクエストされた期間に基づいて設定されます。プロジェクトが保存容量を超過し、古いデータが削除された場合は、後で調整されることがあります。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

ErrorGroupStats

JSON 表現 
{
  "group": {
    object (ErrorGroup)
  },
  "count": string,
  "affectedUsersCount": string,
  "timedCounts": [
    {
      object (TimedCount)
    }
  ],
  "firstSeenTime": string,
  "lastSeenTime": string,
  "affectedServices": [
    {
      object (ServiceContext)
    }
  ],
  "numAffectedServices": integer,
  "representative": {
    object (ErrorEvent)
  }
}
フィールド
group

object (ErrorGroup)

フィルタ条件とは無関係のデータをグループ化します。
count

string (int64 format)

指定されたグループ内でフィルタ条件に一致するイベントの概算合計数。
affectedUsersCount

string (int64 format)

フィルタ条件に一致する、指定されたグループ内の影響を受けるユーザーのおおよその数。ユーザーは、個々のエラー イベントの ErrorContext のデータ（ログイン名や、HTTP リクエストの場合はリモート IP アドレスなど）で区別されます。影響を受けるユーザーの数は、たとえエラーの数がゼロではなくても、そこから影響を受けたユーザーを推定できるデータが規定されない場合は、ゼロとすることができます。ユーザーは、エラーレポートに規定された、リクエスト コンテキスト内のデータに基づいてカウントされます。より多くのユーザーが、たとえばサービス全体のクラッシュによって暗示的に影響を受ける場合は、ここでは反映されません。
timedCounts[]

object (TimedCount)

時間の経過ととも発生する数を概算します。ListGroups から返されるタイムアウト カウントは、次のことが保証されています。

  • 要求された時間間隔内である
  • 重複しない
  • 昇順に並べられる
firstSeenTime

string (Timestamp format)

このグループで最初に確認されたおおよその発生日時。指定されたフィルタ条件と一致し、リクエストで指定された time_range は無視されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
lastSeenTime

string (Timestamp format)

このグループで最後に確認されたおおよその発生日時。指定されたフィルタ条件に一致し、リクエストで指定された time_range は無視されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
affectedServices[]

object (ServiceContext)

指定されたフィルタ条件でエラー数がゼロ以外のサービス コンテキスト。このリストは、複数のサービスが影響を受ける場合には、切り捨てられる場合があります。合計数については、num_affected_services をご覧ください。
numAffectedServices

integer

指定されたフィルタ条件でエラー数がゼロ以外のサービスの合計数。
representative

object (ErrorEvent)

グループ全体の代表として選択された任意のイベント。代表イベントは、グループ全体の迅速なプレビューとして使用されることを目的とします。グループ内のイベントは、通常、相互に十分類似しているので、任意の代表を示すことにより、全体としてのグループの特性を洞察することが可能になります。

ErrorGroup

JSON 表現 
{
  "name": string,
  "groupId": string,
  "trackingIssues": [
    {
      object (TrackingIssue)
    }
  ],
  "resolutionStatus": enum (ResolutionStatus)
}
フィールド
name

string

グループ リソース名。projects/{projectID}/groups/{group_id} または projects/{projectID}/locations/{location}/groups/{group_id} として記述

例: projects/my-project-123/groups/my-group、projects/my-project-123/locations/us-central1/groups/my-group

グループ リソース名では、group_id は特定のエラーグループの一意の識別子です。識別子はエラーログ コンテンツの主要部分から導出され、サービスデータとして扱われます。サービスデータの取り扱いについては、Google Cloud のプライバシーに関するお知らせをご覧ください。

サポートされているロケーションの一覧については、サポートされているリージョンをご覧ください。指定しない場合、デフォルトは global です。
groupId

string

グループの不透明な識別子。このフィールドは Error Reporting システムによって割り当てられ、常に値が入力されます。

グループ リソース名では、group_id は特定のエラーグループの一意の識別子です。識別子はエラーログ コンテンツの主要部分から導出され、サービスデータとして扱われます。サービスデータの取り扱いについては、Google Cloud のプライバシーに関するお知らせをご覧ください。
trackingIssues[]

object (TrackingIssue)

関連するトラッキングの問題。
resolutionStatus

enum (ResolutionStatus)

エラーグループの解決ステータス。

解決ステータスが指定されていない場合は、OPEN と解釈されます

TrackingIssue

JSON 表現 
{
  "url": string
}
フィールド
url

string

問題追跡システムの関連エントリを指す URL。例: https://github.com/user/project/issues/4

TimedCount

JSON 表現 
{
  "count": string,
  "startTime": string,
  "endTime": string
}
フィールド
count

string (int64 format)

指定した期間内のおおよその発生回数。
startTime

string (Timestamp format)

count が参照する期間の開始（この時間も含まれます）。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

count が参照する期間の終了（除外）。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

ServiceContext

JSON 表現 
{
  "service": string,
  "version": string,
  "resourceType": string
}
フィールド
service

string

サービスの識別子。実行可能ファイルの名前、ジョブまたは Google App Engine サービス名など。このフィールドは、新しいコードがデプロイされるたびに変更される version とは異なり、時間の経過とともに比較的安定した少数の値を持つことが想定されています。

Google App Engine ログから抽出されたエラーレポートのサービス名が含まれます。App Engine のデフォルト サービスが使用されている場合は default が含まれます。
version

string

デベロッパーが規定したソースコードのバージョンを表します。たとえば、バージョン ラベルまたは Git SHA-1 ハッシュを表すことがあります。App Engine スタンダード環境の場合、バージョンはアプリのバージョンに設定されます。
resourceType

string

MonitoredResource のタイプ。使用可能な値のリスト: https://cloud.google.com/monitoring/api/resources

値は受信エラーに対して自動的に設定され、エラーを報告するときに設定してはなりません。

ErrorEvent

JSON 表現 
{
  "eventTime": string,
  "serviceContext": {
    object (ServiceContext)
  },
  "message": string,
  "context": {
    object (ErrorContext)
  }
}
フィールド
eventTime

string (Timestamp format)

エラーレポートに規定されたイベントが発生した時刻。レポートにタイムスタンプが含まれない場合は、エラーが Error Reporting システムによって受信された時刻が使用されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
serviceContext

object (ServiceContext)

このエラーが報告された ServiceContext。
message

string

サービスによって報告またはログ記録されたスタック トレース。
context

object (ErrorContext)

エラーが発生したコンテキストに関するデータ。

ErrorContext

JSON 表現 
{
  "httpRequest": {
    object (HttpRequestContext)
  },
  "user": string,
  "reportLocation": {
    object (SourceLocation)
  },
  "sourceReferences": [
    {
      object (SourceReference)
    }
  ]
}
フィールド
httpRequest

object (HttpRequestContext)

エラーがトリガーされた際に処理された HTTP リクエスト。
user

string

クラッシュの原因となった、または、その影響を受けたユーザー。これは、ユーザー ID、メールアドレス、またはユーザーを一意に識別する無作為なトークンとすることができます。エラーレポートを送信する際に、ユーザーがログインしていなければ、このフィールドを空のままにします。この場合、エラーレポート システムは、リモート IP アドレスなど、他のデータを使用して影響を受けるユーザーを区別します。ErrorGroupStats の affected_users_count をご覧ください。
reportLocation

object (SourceLocation)

ソースコード中、エラーを報告することが決定した位置で、通常、エラーがログ記録された場所です。ログに記録された例外では、これは例外がログ記録されたソース行となりますが、通常、例外が捕捉された場所の近くです。
sourceReferences[]

object (SourceReference)

指定されたエラー メッセージの原因となった実行可能ファイルのビルドに使用されたソースコード。

HttpRequestContext

JSON 表現 
{
  "method": string,
  "url": string,
  "userAgent": string,
  "referrer": string,
  "responseStatusCode": integer,
  "remoteIp": string
}
フィールド
method

string

GET、POST などの HTTP リクエストの種類。
url

string

リクエストの URL。
userAgent

string

リクエストにより提供されたユーザー エージェント情報。
referrer

string

リクエストにより提供されたリファラー情報。
responseStatusCode

integer

リクエストのための HTTP レスポンス ステータス コード。
remoteIp

string

リクエストの発信元となった IP アドレス。これは、エラーレポートで提供されたデータに応じて、IPv4、IPv6 または IP アドレスから派生したトークンとすることができます。

SourceLocation

JSON 表現 
{
  "filePath": string,
  "lineNumber": integer,
  "functionName": string
}
フィールド
filePath

string

切り詰められた相対パスまたは本番機のフルパスを含むことができるソースコードのファイル名。
lineNumber

integer

1 ベース。0 は行番号が不明であることを示します。
functionName

string

関数またはメソッドの、人に読める名前。この値には、クラスまたはパッケージ名などの任意のコンテキストを含めることができます。たとえば、Java の場合は my.package.MyClass.method です。

SourceReference

JSON 表現 
{
  "repository": string,
  "revisionId": string
}
フィールド
repository

string

省略可。リポジトリを識別する URI 文字列。例: "https://github.com/GoogleCloudPlatform/kubernetes.git"
revisionId

string

デプロイされたリビジョンの正規の永続的な識別子。例（git）: "0035781c50ec7aa23385dc841529ce8a4b70db1b"

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌