Oracle Cloud Infrastructureドキュメント

カスタム・ログ

カスタム・ログは、カスタム・アプリケーション、他のクラウド・プロバイダまたはオンプレミス環境からの診断情報を含むログです。

カスタム・ログは次の方法で収集できます:

  • PutLogsを使用してカスタム・ログを直接収集します。詳細は、ロギング収集APIおよびREST APIを参照してください。また、PutLogsで使用できるログ・エントリ・ペイロードの例は、カスタム・ログの取込みを参照してください。

  • 統合モニタリング・エージェントを構成します。手順は、エージェントのインストールを参照してください。

    ノート

    Oracle Cloud Agentプラグインを管理する場合、統合モニタリング・エージェントは「カスタム・ログ・モニタリング」と呼ばれます。

カスタム・ログは、Oracle Cloud Infrastructure Computeのインスタンス・ページで表示でき、関連付けられたログ・リソースを持っています。これらは、ロギングの「検索」ページ、「ログ」ページ、または関連付けられた「ログ・グループ」の詳細ページ内でも表示できます。カスタム・ログは、ベア・メタル・インスタンスでもサポートされます。

ノート

Oracle Cloud Infrastructure Monitoringサービスを使用して、カスタム・ログが受け入れおよび収集されるレートを表示することもできます。詳細は、カスタム・ログの受入れ率の表示を参照してください。

統合モニタリング・エージェントは、多くのマシンにインストールでき、ローカル・ディレクトリ(アプリケーションやシステムがログを発行する場所)からログをプルします。エージェントは、ログを解析することもできます。これらはすべて「エージェント構成」で構成されます。エージェント構成を個別に作成してカスタム・ログをそれに関連付けることも、カスタム・ログを作成してから後でエージェント構成を作成することもできます。

エージェント構成は、次を定義するための中心的なメカニズムです:
  • ログを収集するホスト。
  • ホストから収集する特定のログ。
  • 追加パーサー。
  • カスタム・ログの保存先。

カスタム・ログの作成は2ステップのプロセスで、最初にカスタム・ログ・オブジェクトを作成し、次に関連するエージェント構成を作成します。カスタム・ログおよびエージェント構成の作成の詳細は、ログの作成を、エージェントの設定および管理の詳細は、エージェント管理の概要を参照してください。

ノート

エージェントが正しく実行されるように、ファイアウォール設定で次のURIエンドポイントが許可されていることを確認してください:
  • https://auth.<your region>.oraclecloud.com
  • https://ingestion.logging.<your region>.oci.oraclecloud.com

カスタム・ログMetadataおよびストレージ・チャージ

ストレージ・コストを最適化するために、収集中にカスタム・ログ・メタデータが2か所に追加されます:

  • requestレベル
  • log lineレベル

リクエストはログ行のコレクションで、リクエストには1つ以上のログ行を含めることができます。これらのリクエストには、収集されたログ行のバッチが含まれる場合があり、その後に追加のログ行を取り込むためのコールが発生する可能性があります。リクエストは、顧客のデータの送信方法に応じて、異なる量のログ行を持つこともできます。顧客は、リクエスト・レベルのメタデータに対して1回のみ請求されます。リクエスト内の追加のログ行が取り込まれると、このレベルでは追加料金は発生しません。リクエスト・メタデータは、各ログ行にメタデータを追加するのではなく、リクエスト・レベルのリクエスト内のすべてのログ行に適用されるため、ストレージ・コストの節約に役立ちます。

次に、リクエスト・レベルのメタデータの例を示します。

{
"oracle":{
"compartmentid":"ocid1.compartment.oc1..<unique_id>",
"ingestedtime":"2022-05-23T18:00:04.073Z",
"loggroupid":"ocid1.loggroup.oc1.iad.<unique_id>",
"logid":"ocid1.log.oc1.iad.<unique_id>",
"tenantid":"ocid1.tenancy.oc1..<unique_id>"
},
"source":"<customer_data>",
"specversion":"1.0",
"subject":"<customer_data>",
"type":"<customer_data>"
}

最小リクエスト・メタデータ・サイズは500バイトですが、量はsource、subjectおよびtypeフィールドの顧客データのサイズによって異なる場合があります。合計メタデータ・サイズは、これらのフィールドの顧客の特定のデータによって異なります。

実際のログペイロードを含む log lineレベルでは、ログ行ごとに次の 100バイトメタデータが追加されます。

{
"data":{
<log payload>
},
"id":"fb1f6b06-4ed5-4133-a1d0-ad2ffc3addc6",
"time":"2022-05-23T11:54:30.532Z",
}

idおよびtimeは必須であり、対応するログ・イベントと作成時間を示します。

たとえば(source、subjectおよびtypeフィールドに空のデータがある場合)、Oracle Cloud Infrastructure Logging Unified Monitoring Agentが100のログ行を含むリクエストを受信した場合(各ログ行のサイズは1KB)、次の計算ごとに合計追加されたメタデータ・サイズは10.5KBになります:
  • リクエスト・レベル: 500バイト
  • ログ行レベル: 100 (リクエスト内のログ行数) * 100バイト(各ログ行メタデータ) = 10KB

このリクエスト例で送信されたログ行の合計量は、100 * 1 KB = 100 KBです。メタデータを追加すると、結果のログ・ストレージ・サイズは110.5 KBになります。