すべてのプロダクト
Search
ドキュメントセンター

Function Compute:コンテキストとログ形式

最終更新日:Jun 06, 2025

カスタムランタイムでは、共通リクエストヘッダーとログヘッダーには、ランタイムのカスタマイズに使用できるコンテキスト情報と実行ログが含まれています。

Function Compute の共通リクエストヘッダー

次の表は、カスタムランタイムが Function Compute から受信する可能性のある共通リクエストヘッダーについて説明しています。他の Alibaba Cloud サービスにアクセスする場合は、一時的な AccessKey ペアを指定するリクエストヘッダーを使用する必要がある場合があります。既存のアプリケーションを Function Compute に移行する場合は、以下の情報は無視してください。

説明
  • イベント関数と HTTP 関数の両方に共通リクエストヘッダーが含まれています。

  • 共通リクエストヘッダーは、Function Compute によって自動的に生成されます。これらには、関連する権限など、関数に関する基本情報が含まれています。

ヘッダー

説明

x-fc-request-id

リクエスト ID。

x-fc-access-key-id

一時的な AccessKey ID。関数にロールを設定すると、Function Compute は AssumeRole 操作を呼び出して、この AccessKey ID を取得します。

x-fc-access-key-secret

一時的な AccessKey シークレット。関数にロールを設定すると、Function Compute は AssumeRole 操作を呼び出して、この AccessKey シークレットを取得します。

x-fc-security-token

一時的なセキュリティトークン。関数にロールを設定すると、Function Compute は AssumeRole 操作を呼び出して、この一時的なセキュリティトークンを取得します。

x-fc-function-handler

関数のハンドラー。ランタイムが関数の場合、たとえば、カスタムランタイムまたはカスタムコンテナランタイムで実行される関数の場合、このパラメーターは無視され、ランダムな文字列に設定できます。

x-fc-function-memory

関数が使用できる最大メモリ。

x-fc-region

関数が存在するリージョン。

x-fc-account-id

関数オーナーの ID。

x-fc-qualifier

関数を呼び出すときに指定するサービスバージョンまたはエイリアス。詳細については、「バージョンとエイリアスを使用してカナリアリリースを実装する」をご参照ください。

x-fc-version-id

関数を呼び出すときに指定するサービスバージョン。

x-fc-function-name

関数の名前。

x-fc-service-logproject

関数が属するサービスに設定されている Simple Log Service プロジェクト。

x-fc-service-logstore

関数が属するサービスに設定されている Simple Log Service ログストア。

x-fc-control-path

関数のリクエストタイプ。

カスタムランタイムまたはカスタムコンテナランタイムの場合、このパラメーターは、関数が HTTP リクエストによって呼び出されるか、イベントによってトリガーされるかを示します。有効な値:

  • /invoke: リクエストはイベント関数を呼び出すために使用されます。

  • /http-invoke: リクエストは HTTP 関数を呼び出すために送信されます。Function Compute は、リクエストパス、リクエスト本文、およびリクエストヘッダーに関する情報を含む共通ヘッダーをリクエストに追加します。次に、Function Compute はリクエストをカスタムランタイムまたはカスタムコンテナランタイムに転送し、返されたレスポンスヘッダーと本文をクライアントに転送します。

  • /initialize: ランタイム環境を初めて作成するときに Initializer フックを呼び出すために Function Compute によって自動的に開始されるリクエスト。クラスコンストラクターと同様に、Initializer フックはコンテナのライフサイクルで一度だけ呼び出されます。

重要

セキュリティ上の理由から、x-fc-security-token は、カスタムランタイム(Debian 11)ではサポートされなくなりました。引き続き一時的な権限情報が必要な場合は、ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET、および ALIBABA_CLOUD_SECURITY_TOKEN 環境変数を使用して取得できます。詳細については、「環境変数を設定する」をご参照ください。

関数ログ形式

Function Compute でサービスを作成するときに、ロギング機能を有効にすることをお勧めします。このようにして、カスタムランタイムの stdout に出力されるすべてのログは、指定した Simple Log Service のログストアに自動的に収集されます。詳細については、「ロギング機能を設定する」をご参照ください。

カスタムランタイムとカスタムコンテナランタイム以外のランタイムでは、リクエストヘッダーに x-fc-log-type = "Tail" が含まれている場合、x-fc-log-result ヘッダーを含む返されるコンテンツは関数実行ログです。各ログのサイズは最大 4 KB です。 Function Compute コンソール の関数呼び出しの結果でログを表示できます。

説明

ログレベルを指定するために呼び出すことができる API は、プログラミング言語によって異なります。詳細については、「基本」をご参照ください。

参照

  • カスタムランタイムの関数の詳細については、「概要」をご参照ください。

  • カスタムランタイムのコールドスタートと HTTP サーバーの設定方法の詳細については、「原則」をご参照ください。

  • カスタムランタイムで関数を呼び出す方法の詳細については、「Web 関数」をご参照ください。

  • カスタムランタイムで関数インスタンスのライフサイクルフックを実装する方法の詳細については、「関数インスタンスのライフサイクルフック」をご参照ください。