分散トレースを使用する

Cloud Functions の関数に対するすべてのインバウンド リクエストは、基本的なトレースデータのセットを自動的に生成して、関数のレイテンシを測定し、レイテンシの原因の特定に役立ちます。

より詳細なトレースを行うために、Cloud Functions の関数に追加の計測手法を追加できます。これにより、データベース クエリ、API リクエスト、複雑なビジネス ロジックなど、関数内のさまざまなサブオペレーションのリクエストにかかる時間を測定できます。こうしたレイヤ固有の測定時間はスパンと呼ばれます。

トレースの分析は Cloud Trace で表示できます。

トレースのサンプリング レート

Cloud Functions は、Cloud Functions の関数インスタンスごとに 10 秒あたり 1 件のリクエストの最大レートでトレースを実行します。特定のリクエストを強制的にトレースすることもできます。

請求料金

自動的に生成されたトレースは、サンプリングされたものか強制されたものかにかかわらず、課金されません。ただし、Cloud Trace ライブラリを使用して、独自のスパンを Cloud Functions 提供のスパンに関連付けて追加すると、Cloud Trace によって課金されます。

計測手法を追加するタイミング

自動生成されたトレースデータよりも多くのトレース情報が必要な場合は、計測手法のコードをサービスに追加して、追加のトレースを有効にする必要があります。たとえば、計測手法を以下に追加する必要があります。

  • サービスが API リクエストから結果を得るために要する時間を監視するなどの、カスタム トレーススパンを作成します。
  • トレース コンテキストを伝搬すると、Cloud Trace が複数のサービスにまたがるリクエスト フローを単一のリクエストとして表示します。

計測手法を追加するには、アプリケーションのトレースを計測可能にするをご覧ください。

トレースを表示する

トレースデータの分析を表示するには、トレースの表示をご覧ください。