Oracle Log Analyticsには、REST APIログ収集用のOracle定義のログ・ソースがすでに用意されています。使用可能なOracle定義REST APIソースまたはOracle定義パーサーを使用できるかどうかを確認します。そうでない場合は、次のステップを使用して新しいログ・ソースを作成します。

開始する前に、ログに適した新しいパーサーを作成する必要がある場合は、完了します。パーサーの作成を参照してください。

1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「Log Analytics」で、「管理」をクリックします。「管理の概要」ページが開きます。

   管理リソースが、左側のナビゲーション・ペインの「リソース」の下にリストされます。「ソース」をクリックします。

2. 「ソース」ページが開きます。「ソースの作成」をクリックします。

   「ソースの作成」ダイアログ・ボックスが表示されます。

3. 「名前」フィールドに、ログ・ソースの名前を入力します。

4. 「ソース・タイプ」リストから、「REST API」を選択します。

5. 「エンティティ・タイプ」をクリックし、アプリケーションを最も適切に識別するタイプを選択します。

6. 「パーサー」をクリックし、収集するログのタイプに適したパーサーを選択します。

7. 要件に応じて、「エンドポイント」タブで、「ログ・エンドポイントの追加」または「複数のログのリスト・エンドポイントの追加」をクリックします:

   • ログを継続的に収集できる単一のログ・エンドポイントURLを指定するには、「ログ・エンドポイントの追加」をクリックします。「ログ・エンドポイントの追加」ダイアログ・ボックスが開きます。

     次の情報を入力します:

     1. ログ・エンドポイント名を入力します。

     2. ログURLを作成して、ログを定期的に収集します。エンドポイントURLのタイプのログ・エンドポイントURLを参照してください。

     3. APIメソッドGETまたはPOSTを選択します。

        「POST」を選択した場合は、メソッドの「POSTペイロード」を入力し、JSON、Text、Javascript、HTMLおよびXMLからリクエスト・コンテンツのタイプを選択します。

     4. オプションで、ログ・プロキシ・サーバーURLを指定します。

     5. オプションで、「リクエスト・ヘッダーの表示」をクリックしてセクションを展開し、「追加」をクリックして、「名前」から「値」のペアの形式でリクエスト・ヘッダーを指定します。

     6. オプションで、「問合せパラメータの表示」をクリックしてセクションを展開し、「追加」をクリックして、「名前」から「値」のペアの形式で問合せパラメータを指定します。

     7. 「資格証明」セクションで、「ログ資格証明タイプ」を選択します。「REST APIログ収集の資格証明タイプの選択」を参照してください。

     8. 入力した構成情報を検証するには、「検証」をクリックします。エラーがある場合は、それらを修正します。

        「変更の保存」をクリックします。

   • 複数のログを収集するためのログ・エンドポイントURLのリストの生成に使用できる情報を含むJSONレスポンスを返すURLを指定するには、「複数のログのリスト・エンドポイントの追加」をクリックします。「複数ログのリスト・エンドポイントの追加」ダイアログ・ボックスが開きます。

     1. 「リスト・エンドポイントの構成」タブ:

        • 「ログ・リスト・エンドポイント名」を入力します。

        • ログ・リストURLを作成して、ログ・ファイルに関する情報を取得します。エンドポイントURLのタイプのログ・リスト・エンドポイントURLを参照してください。例:

          https://example.org/fetchlogfiles_data

        • オプションで、ログ・プロキシ・サーバーURLを指定します。

        • APIメソッドGETまたはPOSTを選択します。

          「POST」を選択した場合は、メソッドの「POSTペイロード」を入力し、JSON、Text、Javascript、HTMLおよびXMLからリクエスト・コンテンツのタイプを選択します。

        • オプションで、「リクエスト・ヘッダーの表示」をクリックしてセクションを展開し、「追加」をクリックして、「名前」から「値」のペアの形式でリクエスト・ヘッダーを指定します。

        • オプションで、「問合せパラメータの表示」をクリックしてセクションを展開し、「追加」をクリックして、「名前」から「値」のペアの形式で問合せパラメータを指定します。

        • 「資格証明」セクションで、「ログ資格証明タイプ」を選択します。「REST APIログ収集の資格証明タイプの選択」を参照してください。

        • 「次」をクリックします。

     2. 「ログ・エンドポイントの構成」タブ:

        • ログ・リスト・エンドポイントのサンプル・レスポンスを指定します。これは、前のタブで指定したログ・リスト・エンドポイントに対して取得するレスポンスの例です。例:

          { "totalSize": 4, "records": [ {"id": "firstId", "type": "firstType"}, {"id": "secondId", "type": "secondType"} ] }

          前述の例から、JSONパスrecords[*].idをエンドポイントURLで使用できます。JSONパス変数の詳細は、REST APIログ収集の変数を参照してください。

        • ログ・エンドポイント名を入力します。

        • ログURLを構築し、ログ・リスト・エンドポイントに対するレスポンス例で識別されるJSONパス・キーを組み込むことで、定期的にログを収集します。エンドポイントURLのタイプのログ・エンドポイントURLを参照してください。例:

          https://example.org/fetchLogs?time={START_TIME}&id={testLogListEP:$.records[*].id}

        • オプションで、ログ・プロキシ・サーバーURLを指定します。

        • APIメソッドGETまたはPOSTを選択します。

          「POST」を選択した場合は、メソッドの「POSTペイロード」を入力し、JSON、Text、Javascript、HTMLおよびXMLからリクエスト・コンテンツのタイプを選択します。

        • オプションで、ログ・プロキシ・サーバーURLを指定します。

        • オプションで、「リクエスト・ヘッダーの表示」をクリックしてセクションを展開し、「追加」をクリックして、「名前」から「値」のペアの形式でリクエスト・ヘッダーを指定します。

        • オプションで、「問合せパラメータの表示」をクリックしてセクションを展開し、「追加」をクリックして、「名前」から「値」のペアの形式で問合せパラメータを指定します。

        • 「資格証明」セクションで、「ログ資格証明タイプ」を選択します。「REST APIログ収集の資格証明タイプの選択」を参照してください。

        • 「次」をクリックします。

     3. 「確認および追加」タブ: 前のタブで指定した構成情報が検証されます。ログの収集元となるURLのリストを確認します。

        エラーがある場合は、それらを修正します。

        「保存」をクリックします。

8. 「ソースの作成」をクリックします。

ログ・リスト・エンドポイントURL: ログ・リスト・エンドポイントURLは、ログを収集するためのログ・エンドポイントURLのリストの作成に使用できる情報を含むJSONレスポンスを返す必要があります。JSONレスポンスからログ・エンドポイントのリストを作成するために必要なJSONパス変数を指定します。また、マクロ{START_TIME}および{CURR_TIME}を使用して、対応する時間値をURLに動的に挿入できます。

ログ・エンドポイントURL: ログ・エンドポイントURLは、特定のREST APIエンドポイントから定期的にログを収集するために使用されます。マクロ{START_TIME}、{CURR_TIME}および{TIME_WINDOW}を使用すると、対応する時間値をURLに動的に挿入できます。{OFFSET}マクロを使用すると、ページ区切りをサポートできます。ログ・リスト・エンドポイント・コールのレスポンスからのJSONパス変数を使用して、特定のプロパティを置換することもできます。

• {START_TIME}: ログを収集する時間を指定します。
• {OFFSET}: ページ区切りログ収集を処理するため
• {CURR_TIME}: 現在の時刻を指定します。
• {TIME_WINDOW}: コレクションの間隔または期間を指定します。

マクロの使用の詳細は、START_TIMEマクロ、CURR_TIMEマクロ、OFFSETマクロおよびTIME_WINDOWマクロを参照してください。

ログ・エンドポイントURLで指定できるログ・リスト・エンドポイント・レスポンスの変数、JSONパスの例および変数フィルタの使用の詳細は、REST APIログ収集の変数を参照してください。

START_TIMEマクロを使用して、ログを収集する必要がある時間を指定します。START_TIMEマクロは、エンドポイントURL、フォーム・パラメータまたはPOSTペイロードで使用できます。

次の例は、START_TIMEマクロで指定されたタイムスタンプより大きいログを収集するエンドポイントURLを示しています。

https://example.org/fetchLogs?sortBy=timestamp&sortOrder=ascending&filter=timestamp+gt+{START_TIME:yyyy-MM-dd'T'HH:mm:ss.SSSZ}

構文:

{START_TIME<+nX>:<epoch | timestamp format supported by SimpleDateFormat java class>.TZ=<timezone name>}

• nは、日付範囲の時間値です。Xは、日数(D)、時間数(h)、分数(m)、月数(M)、年(Y)で表されます。

• +nXは、開始時間に追加する日数、時間数、分数、月数または年数です。オプションです。たとえば、+3Dです。

• サポートされている時間形式は、javaクラスSimpleDateFormatと同じです。デフォルトの時間書式はyyyy-MM-dd'T'HH:mm:ss.SSSZです。たとえば、2001-07-04T12:08:56.235-0700のようになります。

  epochまたは時間書式の指定はオプションです。エポックが指定されている場合、マクロはエポックミリ秒値に置き換えられます。

  SimpleDateFormatでサポートされているタイムスタンプ書式については、Java Platform Standard Ed. 8: Class SimpleDateFormatを参照してください。

• TZは、タイムスタンプのタイムゾーンを指定するためのものです。エポックがすでに指定されている場合は適用されません。サポートされている形式は、javaクラスTimeZoneの3文字のID (UTCなど)と同じです。

• このマクロの複数のインスタンスをURLに含めることができます。

• 例:

  1. {START_TIME:yyyy-MM-dd'T'HH:mm:ss.SSS.TZ=UTC}
  2. {START_TIME:epoch}

CURR_TIMEマクロを使用して、REST APIエンドポイントURL、フォーム・パラメータおよびPOSTペイロードに現在の時刻を挿入します。

次の例は、問合せパラメータでCURR_TIMEマクロを使用するエンドポイントURLを示しています。

https://example.org/fetchLogs?sortBy=timestamp&sortOrder=ascending&time={CURR_TIME:yyyy-MM-dd'T'HH:mm:ss.SSSZ}

• マクロを使用する形式は、START_TIMEマクロと同じです。

• このマクロの複数のインスタンスをURLに含めることができます。

OFFSETマクロは、ページ区切りレスポンスを提供するエンドポイント、またはAPIレスポンスのオフセット動作を処理する場合に使用します。OFFSETマクロは、REST APIエンドポイントURL、フォーム・パラメータおよびPOSTペイロードで使用して、単一のログ収集サイクルで複数のページまたはチャンクをフェッチできます。

フォーマット: {OFFSET(<start value>, <increment>)}

• OFFSETマクロは、特定のログ・エンドポイントのページ区切り結果に関するデータを反復的にコールおよび収集して、使用可能なすべてのレコードを取得するために使用されます。最初のREST APIリクエスト・コールは、開始値で始まり、後続の各コールで増分の値によって増分されます。これらの再帰的な索引ベース・コールは、ログ・エントリがこれ以上見つからない場合に停止されます。オフセットは、次の収集サイクルに繰り越されません。各収集サイクルのデフォルト値または初期値から開始します。

• 前述の形式では、開始値が索引の初期値で、デフォルト値は0です。開始値を指定することはオプションです。

  使用可能な値: 0を含む正の整数

• 前述の形式では、incrementは後続のコールで開始値に追加する値を指定します。デフォルト値は1です。増分値を指定することはオプションです。

  使用可能な値: 正の整数のみ。0を除外します。

• URLには、このマクロのインスタンスを1つのみ含めることができます。

次の例は、OFFSETマクロの様々な使用方法を示しています。

• {OFFSET}

  デフォルト値の開始値 = 0、増分 = 1を使用します。

• {OFFSET(5)}

  開始値 = 5、増分 = 1 (デフォルト)

• {OFFSET(5,2)}

  開始値 = 5、増分 = 2

次の例は、OFFSETマクロを使用するエンドポイントURLを示しています。

https://example.org/fetchLogs?startIndex={OFFSET(0,1000)}&count=1000

前述の例で、OFFSET(0,1000)は、最初のコールで開始値が0になり、後続のコールで1000ずつ増加することを示します。したがって、OFFSETマクロが解釈される場合、複数のコールのエンドポイントURLは次のようになります。

最初のコール: https://example.org/fetchLogs?startIndex=0&count=1000

2回目のコール: https://example.org/fetchLogs?startIndex=1000&count=1000

TIME_WINDOWマクロを使用して、ログを収集する収集間隔を指定します。REST APIエンドポイントURLで使用すると、エージェント収集間隔に関係なく、分、時間または日数でログをフェッチできます。たとえば、時間ウィンドウが1d (1日)で、エージェント間隔が10分の場合、後続のログ収集は1日後にのみ実行されます。

次の例では、エンドポイントURLでTIME_WINDOWを6hとして指定して、ログ収集間隔を6時間に設定します。

https://example.org/fetchLogs?timewindow={TIME_WINDOW(6h)}

フォーマット: {TIME_WINDOW(<number><timeunit>)}

前述の形式:

• number: ゼロより大きい数字。

• timeunit: 時間の場合はh、日の場合はd、分の場合はm。デフォルト値はd (日)です。

エージェント収集間隔が指定された時間ウィンドウより小さいことを確認してください。TIME_WINDOWマクロは、エンドポイントで1回のみ使用できます。

変数を使用して、ログ・リスト・エンドポイントによってレスポンスの一部として提供される属性を、実行時に動的にログ・エンドポイントのリクエストに置換します。変数は、URL、フォーム・パラメータ、POSTペイロードまたはログ・エンドポイントのHTTPリクエスト・ヘッダー値で使用できます。

ログ・リスト・エンドポイントへのコールが失敗した場合、依存関係のためにログ・エンドポイントからのログ・メッセージは収集されません。

ログ・エンドポイントの変数の形式:

{<log_list_endpoint_name>:<json path(<filter_field_name>='<value>')>}

• 前述の形式では、log_list_endpoint_nameはログ・リスト・エンドポイントの名前です。

  フィルタ(<filter_field_name>=<value>)はオプションです。filter_field_nameに一致する属性のみが、ログ・リスト・エンドポイントのJSONレスポンスから取得され、ログ・エンドポイントで使用されます。例:

  https://www.example.com/log/{foo:$.items[*].links[*].href(rel='self')}

  フィルタの詳細な例は、フィルタの例を参照してください。

• プロパティ値のフェッチには、JSONコンテンツ・タイプのみがサポートされています。

• 同じ変数を複数回指定できます。

• 変数は有効なリスト・エンドポイントのみを参照でき、ログ・エンドポイントは参照できません。

• 次のJSONパス形式がサポートされています: 単純なJSONパス、配列JSONパスおよび複数の配列JSONパス。

{
    "foo" : 
    {
        "abc" : "result"
    }
}

{
    "foo" : {
        "id" : "id1"
    },
    "foo2" : {
        "ID" : "id2",
        "id" : "id3"
    }
}

{
    "foo" : {
        "id" : "id1",
        "abcd" : "value1"
    },
    "foo2" : {
        "id" : "id2"
    }
}

{
     "records": [
         {"id": "firstId", "type":"firstType"},
         {"id":"secondId", "type":"secondType"}
     ],
     "items": [
         {"name":"firstName", "field":"value"},
         {"name":"secondName", "field":"value"},
         {"name":"thirdName", "field":"value"}
     ]
}

https://www.example.com/url_list

{
  "records": [ { "id": "firstId", "type": "firstType" }, { "id": "secondId", "type": "secondType" } ],
  "items": [ { "name": "firstName", "field": "value" }, { "name": "secondName", "field": "value" }, { "name": "thirdName", "field": "value" } ]
}

https://www.example.com/{getlist:$.records[*].id}/{getlist:$.items[*].name}

{
    "items": [
        {
            "BusinessEventCode": "JournalBatchApproved",
            "CreationDate": "2019-07-27T17:19:19.261+00:00",
            "links": [
                {
                    "rel": "self",
                    "href": "/erpBusinessEvents/self/100100120766717"
                },
                {
                    "rel": "canonical",
                    "href": "/erpBusinessEvents/rel/100100120766717"
                }
            ]
        }
    ]
}

https://www.example.com/log/{foo:$.items[*].links[*].href(rel='self')}

https://www.example.com/log/erpBusinessEvents/self/100100120766717

エージェントとREST APIソース間の接続を認可するには、まずエージェントの資格証明ストアでAPI資格証明を構成します。エージェント側の管理エージェント・サービスでソース資格証明を構成した後、REST APIログ・ソースの作成時にこの情報を使用できます。

管理エージェントがログ発行ホストからデータを収集できるように、管理エージェント・サービスのソース資格証明を構成するには、管理エージェントのソース資格証明を参照してください。

ログ・エンドポイントまたはログ・リスト・エンドポイントを追加するときに、「ログ資格証明タイプ」を選択して、ワークフローに資格証明情報を指定します。次のいずれかのオプションを選択します。

• なし
• 基本認証: 管理エージェント・サービスで作成した資格証明のログ資格証明名を指定します。
• 静的トークン: 管理エージェント・サービスで作成した資格証明のログ資格証明名を指定します。
• 動的トークン(OAuth 2.0):

  管理エージェント・サービスで作成したトークンのトークン資格証明名を指定します。また、「トークン・エンドポイント名」、「トークン・エンドポイントURL」、「付与タイプ」、およびオプションで「スコープ」などのトークン情報を指定します。

  トークン・プロキシがログ・エンドポイントと同じ場合は、「ログ・エンドポイントと同じプロキシ」チェック・ボックスを有効にしたままにします。そうでない場合は、チェック・ボックスを無効にし、「トークン・プロキシ・サーバーのURL」を指定します。

認証タイプへの資格証明タイプのマッピング:

sslトラストストアのプロパティには、次の情報が含まれています。

• "ssl_trustStoreType": ストアのタイプ(たとえば、JKS)。

• "ssl_trustStoreLocation": トラスト・ストアのパス

• "ssl_trustStorePassword": トラスト・ストアのパスワード(オプション)

資格証明JSONの属性に関する次の点に注意してください:

• source: 値はlacollector.la_rest_apiである必要があります

• name: 資格証明に適した名前

• type: これは、前述の資格証明タイプ表の「管理エージェントでの資格証明タイプ」列で指定されている値のいずれかである必要があります。

資格証明JSONの例を参照してください。

{
  "source":"lacollector.la_rest_api",
  "name":"ExampleRestAPICreds",
  "type":"HTTPSBasicAuthCreds",
  "description":"These are HTTPS (BasicAuth) credentials.",
  "properties":
  [
    { "name":"HTTPSUserName", "value":"CLEAR[admin]" },
    { "name":"HTTPSPassword", "value":"CLEAR[myHTTPSPassword]" }
  ]
}

{
  "source":"lacollector.la_rest_api",
  "name":"ExampleRestAPICreds",
  "type":"HTTPSCreds",
  "description":"These are HTTPS (BasicAuth) credentials.",
  "properties":
  [
    { "name":"HTTPSUserName", "value":"CLEAR[admin]" },
    { "name":"HTTPSPassword", "value":"CLEAR[myHTTPSPassword]" },
    { "name":"ssl_trustStoreType", "value":"JKS" },
    { "name":"ssl_trustStoreLocation", "value":"/scratch/certs/mycert.keystore" },
    { "name":"ssl_trustStorePassword", "value":"mySSLPassword" }
  ]
}

{
  "source":"lacollector.la_rest_api",
  "name":"ExampleRestAPICreds",
  "type":"HTTPSTokenCreds",
  "description":"These are HTTPS (Token) credentials.",
  "properties":
  [
    { "name": "HTTPSToken", "value": "CLEAR[token value]" },
    {"name": "HTTPSTokenType", "value": "CLEAR[Bearer]" }
  ]
}

{
  "source":"lacollector.la_rest_api",
  "name":"ExampleRestAPICreds",
  "type":"HTTPSTokenCreds",
  "description":"These are HTTPS (Token) credentials.",
  "properties":
  [
    { "name": "HTTPSToken", "value": "CLEAR[token value]" },
    {"name": "HTTPSTokenType", "value": "CLEAR[Bearer]" },
    { "name":"ssl_trustStoreType", "value":"JKS" },
    { "name":"ssl_trustStoreLocation", "value":"/scratch/certs/mycert.keystore" },
    { "name":"ssl_trustStorePassword", "value":"mySSLPassword" }
  ]
}

Fusion Applications監査ログを収集するには、次のステップに従います。Fusion Applicationsで使用可能なOracle定義ソースのリストは、Oracle定義ソースを参照してください。

トピック:

• 前提条件
• Fusion Applicationsからの監査ログ収集の設定