ファンクション・メトリック
oci_faasメトリック・ネームスペースで、OCI Functionsによって生成されるメトリックを確認します。
メトリック、アラームおよび通知を使用して、OCIファンクションにデプロイしたファンクションのヘルス、容量およびパフォーマンスをモニターできます。
このトピックでは、メトリック・ネームスペースoci_faas
(OCIファンクション・サービス)によって生成されたメトリックについて説明します。
リソース: ファンクション
OCIファンクション・サービス・メトリックの概要
OCI Functionsは、ファンクションの実行を監視し、次のようなメトリックを収集およびレポートします:
- ファンクションが呼び出される回数。
- ファンクションを実行する時間の長さ。
- エラー・レスポンス(エラー・コードおよびエラー・メッセージを含む)で失敗したファンクションを呼び出すリクエストの数。
- レスポンスで「429 リクエストが多すぎます」エラーを返したファンクションの呼出しリクエストの数(「スロットル調整されたファンクション呼出し」と呼ばれます)。
- 同時ファンクションの実行およびプロビジョニングされた同時実行性のために割り当てられるメモリーの量(OCIファンクションのメモリー使用量および可用性の監視を参照)。
頻度はメトリックによって異なりますが、デフォルトのサービス・メトリックの頻度は通常60秒です(1分当たりに少なくとも1つのデータ・ポイントがポストされます)。
前提条件
IAMポリシー: リソースをモニターするには、管理者が作成するポリシーで、必要なタイプのアクセス権が付与されている必要があります。ユーザーがコンソールを使用しているか、SDK、CLIまたはその他のツールでREST APIを使用しているかにかかわらずです。ポリシーでは、モニタリング・サービスおよびモニター対象のリソースにアクセス権を付与する必要があります。アクションを実行しようとして、権限がない、または認可されていないというメッセージが表示された場合は、管理者に連絡して、付与されているアクセスのタイプと作業する必要があるコンパートメントを確認してください。モニタリングのユーザー認可の詳細は、「IAMポリシー」を参照してください。
OCIファンクションで生成されるメトリックへのアクセスに必要なポリシー・ステートメントの詳細は、OCIファンクション・ユーザーにファンクション関連リソースへのアクセス権を付与するポリシー・ステートメントを参照してください。
使用可能なメトリック: oci_faas
次の表に示すメトリックは、作成するファンクションで自動的に使用可能になります。これらのメトリックを取得するためにリソースのモニタリングを有効にする必要はありません。
OCI関数メトリックには、次のディメンションが含まれます:
- APPLICATIONID
- ファンクションを含むアプリケーションのOCID。
- アプリケーションシェイプ
- アプリケーションのアーキテクチャ。
- COMPARTMENTID
- アプリケーションを含むコンパートメントのOCID。
- 在庫タイプ
- 関数が呼び出された方法(SyncまたはDetachedのいずれか)。このディメンションは、一部の商用レルムでのみ使用できます。
- RESOURCEDISPLAYNAME
- ファンクションを含むアプリケーションの名前およびファンクションの名前。
- RESOURCEID
- ファンクションのOCID。
- 生産資源名
- メトリックが適用されるリソースの名前(アプリケーション、またはアプリケーションおよびファンクション)。
- RESPONSETYPE
- ファンクションが呼び出されたときのレスポンス(Success、Error、またはThrottled)。
- ユーステナンシID
- ファンクションを起動したテナンシのOCID。
メトリック | メトリック表示名 | 単位 | 説明 | ディメンション |
---|---|---|---|---|
AllocatedProvisionedConcurrency |
プロビジョニングされたファンクションの同時実行性 | MB | プロビジョニングされた同時実行性スロットによって消費されるメモリー。 | applicationId
|
AllocatedTotalConcurrency |
割り当てられた機能同時実行性 | MB | 割り当てられた同時メモリーの合計。 | applicationShape
|
FunctionExecutionDuration
|
ファンクションの実行時間 | ms | ファンクションの合計実行時間。ミリ秒単位で表現されます。 | applicationId
|
FunctionInvocationCount
|
ファンクション呼出し | count | ファンクション呼出しの合計数。 | applicationId
|
FunctionResponseCount
|
このメトリックは、次のデフォルトのメトリック・チャートで使用されます。 エラー ( スロットル ( |
count | ファンクション・レスポンスの合計数。 | applicationId
responseType = "Error" の場合、個々の関数で次のディメンションを使用できます。
|
コンソールの使用
- ナビゲーション・メニューを開き、「開発者サービス」を選択します。「ファンクション」で、「アプリケーション」を選択します。
- OCI Functionsで使用しているリージョンを選択します。
Fn ProjectのCLIコンテキストで指定されているDockerレジストリと同じリージョンを使用することをお薦めします。 Oracle Cloud Infrastructureに接続するためのFnプロジェクトのCLIコンテキストの作成を参照してください。
-
メトリックを表示するファンクションを使用するアプリケーションを含むコンパートメントを選択します。
「アプリケーション」ページには、選択したコンパートメント内のすべてのアプリケーションが表示されます。
- メトリックを表示するファンクションを含むアプリケーションの名前を選択します。
- メトリックを表示するファンクションの名前を選択します。
-
「リソース」で、「メトリック」を選択します。
「メトリック」ページには、OCIファンクションのメトリック・ネームスペースによって生成される各メトリックのチャートが表示されます。表示されるメトリックの詳細は、使用可能なメトリック: oci_faasを参照してください。
予想されるファンクションのメトリック・データが表示されない場合は、次の原因および解決方法を参照してください。
問題 | 考えられる原因 | 解決策 |
---|---|---|
ファンクションの欠落: 呼び出したファンクションが「呼出し数」チャートにありません。 | チャート範囲(期間またはX軸ウィンドウ)が、呼出し時間をカバーしていません。 | 必要に応じて、チャート範囲または期間を調整します。 |
メトリック・データのギャップ: チャート線が不連続です。チャート内でデータを連続した線として経時的に表示したいが、線にギャップがあります。 | ギャップが示す時間にメトリック・データが存在しません。 | チャート間隔を広げることで表示をスムーズにして、ギャップが取り除かれるかどうかを確認します。 |
空のチャート: エラーおよびスロットル・チャートにデータが表示されません。 | 指定したチャート範囲では、これらのチャートのメトリック・データは存在しません。エラーは発生せず、スロットルが適用されたリクエストはありません。空のエラーおよびスロットル・チャートが予想されます。 | なし。 |
スロットル・データ: スロットル・チャートにデータが表示されています。どうすればよいでしょうか。 | スロットル・チャートのデータは、レスポンスで「429 リクエストが多すぎます」エラーを戻したファンクションの呼出しリクエストが少なくとも1つあることを示します。 | スロットルが適用されている呼出しリクエストを再発行します。今後の呼出しリクエストの発行頻度を低くします。 |
- ナビゲーション・メニューを開き、「開発者サービス」を選択します。「ファンクション」で、「アプリケーション」を選択します。
- OCI Functionsで使用しているリージョンを選択します。
Fn ProjectのCLIコンテキストで指定されているDockerレジストリと同じリージョンを使用することをお薦めします。 Oracle Cloud Infrastructureに接続するためのFnプロジェクトのCLIコンテキストの作成を参照してください。
-
ファンクション・メトリックを表示するアプリケーションを含むコンパートメントを選択します。
「アプリケーション」ページには、選択したコンパートメント内のすべてのアプリケーションが表示されます。
- ファンクション・メトリックを表示するアプリケーションの名前を選択します。
-
「リソース」で、「メトリック」を選択します。
「メトリック」ページには、OCIファンクションのメトリック・ネームスペースによって生成される各メトリックのチャートが表示されます。表示されるメトリックの詳細は、使用可能なメトリック: oci_faasを参照してください。
- ナビゲーション・メニューを開き、「監視および管理」を選択します。「モニタリング」で、「サービス・メトリック」を選択します。
- OCI Functionsで使用しているリージョンを選択します。
Fn ProjectのCLIコンテキストで指定されているDockerレジストリと同じリージョンを使用することをお薦めします。 Oracle Cloud Infrastructureに接続するためのFnプロジェクトのCLIコンテキストの作成を参照してください。
-
ファンクション・メトリックを表示するアプリケーションを含むコンパートメントを選択してください。
-
「メトリック・ネームスペース」で、oci_faasを選択します。
「サービス・メトリック」ページにより、選択したメトリック・ネームスペースによって生成される各メトリックのチャートを示すように、ページが動的に更新されます。表示されるメトリックの詳細は、使用可能なメトリック: oci_faasを参照してください。
APIの使用
APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。