カスタム・ログ

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

カスタム・ログは次の方法で収集できます:
  • 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か所に追加されます:

  • リクエスト・レベル
  • ログ行レベル

リクエストはログ行の集合で、リクエストには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バイトですが、この量は、sourcesubjectおよびtypeフィールドの顧客データのサイズによって異なる場合があります。合計メタデータ・サイズは、これらのフィールド内の顧客の特定のデータによって異なる場合があります。

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

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

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

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

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