メインコンテンツまでスキップ
非公開のページ
このページは非公開です。 検索対象外となり、このページのリンクに直接アクセスできるユーザーのみに公開されます。

Extend Event Handler - メトリクス

Last updated on February 4, 2026

注釈:本資料はAI技術を用いて翻訳されています。

Image shows Grafana Cloud dropdown with AccelByte event_handler_metrics_highlighted

メトリクスのリスト

non-message_type

  • total_messages_received: メッセージが受信されるたびにインクリメントされるトップレベルのメトリクスです。このメトリクスがインクリメントされると、Kafka Sink ConnectorがKafkaから送信されるメッセージを受信し、その後の処理が行われる前の状態を示します。

message_type

  • filtered_messages: 読み取り可能なprotoメッセージ名で処理されているメッセージ数のメトリクスです。protoメッセージ名は、どのgRPC呼び出しを行うかをマッピングするために使用されます。

  • grpc_method_not_implemented_skipped: gRPCが見つからなかったため、gRPCサービス名キャッシュからの呼び出しができなかったことを示します。その結果、gRPCメソッドの呼び出しがスキップされます。gRPCサービス名キャッシュは、コネクタの起動時に構築され、gRPCサーバーに対してgRPCリフレクションによってメソッドのリストを照会します。このキャッシュは、gRPCが呼び出される前に最初にチェックされます。

  • grpc_method_disabled_skipped: gRPCサービス名キャッシュがgRPCリフレクションによって見つかったが、以前に呼び出されたときにgRPCサーバーからIMPLEMENTEDだったため、そのステータスが無効になっていることを示します。grpc_server_invocation_unimplementedもインクリメントされます。詳細についてはgrpc_server_invocation_unimplementedを参照してください。gRPCサーバーと実装されたメソッドのリストのコネクタは同じポッド内に存在するため、常に同期しているはずであり、gRPC呼び出しがスキップされることはないはずです。

フロー

マッピングファイルからメッセージ名の読み取りと検索が正常に完了した後:

  • rpc_server_invocation_initiatedがインクリメントされ、gRPC Extendアプリのマッピングされたメソッドが呼び出されます。

gRPCサーバー呼び出し時:

  • grpc_server_invocation_successfulは、gRPC ExtendアプリがステータスコードOKでExtendアプリに正常に応答を返したときにインクリメントされます。

  • grpc_server_invocation_unimplementedは、gRPC Extendアプリを呼び出したがアプリがUNIMPLEMENTEDで応答した場合です。これは、コネクタ内のgRPCサービス名キャッシュ(gRPC Extendアプリのサイドカー)が、gRPC Extendアプリが完全に起動した後に構築されたために発生します。

  • grpc_server_invocation_retriable_exceptionsは、gRPC Extendアプリを呼び出したがアプリがリトライ可能と見なされる許容される例外で応答した場合です:

    リトライ可能なgRPC Extendアプリの例外のリスト:

    • UNAVAILABLE
    • CANCELLED
    • DEADLINE_EXCEEDED
    • RESOURCE_EXHAUSTED
    • INTERNAL
  • grpc_server_invocation_other_exceptions: gRPCが呼び出されたがgRPC Extendアプリがリトライ可能と見なされない他の例外で応答した場合です。

全体的な例外メトリクス

  • unexpected_exceptions_unknown_message_type: Kafkaメッセージから正確なメッセージタイプ(protoメッセージ名)を区別できないリトライ不可能な例外があることを示します。

  • unexpected_exceptions: Kafkaメッセージからメッセージタイプ(protoメッセージ名)を区別できるリトライ不可能な例外があることを示します。

メトリクスの命名規則

メトリクスの命名規則は次のとおりです:

metrics_grpc_bridge:`<task_connector_id>`:`<topic>`:`<message_type_if_applicable>`:`<metric_name>`_Count

この例では、タスクコネクタインスタンスID 0とトピックaccelbyte_dev_userAuthenticationを使用して、メトリクスは次のように識別されます:

  • 最初のものは、トピックのtotal_messages_receivedに属するトップレベルのメトリクスです。
  • 残りは、メッセージタイプ(protoメッセージ名)に属するメトリクスです: userLoggedIn

Image shows Grafana Cloud dropdown with AccelByte event_handler_metrics_highlighted