管理エージェントの拡張構成オプション

ファイルのタイムゾーンおよび文字エンコーディングの手動指定

エージェント・インストール・フォルダの構成プロパティを編集して、ログ・ファイルのプロパティを手動で指定できます。

このタスクは、Windowsイベント以外のすべてのログに対して実行できます。

  1. 特定のパターンまたはログ・ソース(あるいはその両方)にプロパティを適用する場合、そのパターンIDとソースIDを書き留めます。エージェント・インストール・フォルダagent_inst/state/laStorage/os_file/os_file.xmlにあるconfig xmlファイルを開きます。

    • パターンIDの例: <Pattern id="495071102827757094" name="/tmp/w*.mgr" include="true">
    • ソースIDの例: <LogSource id="-2574377491167724513" name="SS Concurrent Manager Logs" sourceType="os_file"/>

    エージェント・インストール・フォルダの場所は、ソース・タイプによって異なります。たとえば、SQLデータベースの場所はagent_inst/state/laStorage/database_sql/database_sql.xmlです。

  2. 場所agent_inst/config/emd.propertiesのプロパティ・ファイルemd.propertiesを編集し、次のプロパティを追加してOracle Logging Analyticsのデフォルト構成をオーバーライドします:

    loganalytics.src.override_config=true
        
  3. 次のいずれかの例から選択して、ファイルemd.propertiesでタイムゾーンのtzおよび文字エンコーディングのencプロパティを指定します:

    • すべてのソースおよびパターンにプロパティを適用します:

      loganalytics.src.addl_src_ptn_configs=tz=UTC,enc=EUC-JP
    • 特定のログ・ソースにのみプロパティを適用します:

      loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,tz=UTC,enc=EUC-JP;srcid=-2574377491167724512,enc=UTF-8

      この例で、タイムゾーンUTCおよび文字エンコーディングEUC-JPプロパティはソース-2574377491167724513に適用され、文字エンコーディングのプロパティUTF-8はソース-2574377491167724512に適用されます。

    • 特定のパターンにのみプロパティを適用します:

      loganalytics.src.addl_src_ptn_configs=ptnid=495071102827757094,tz=UTC,enc=EUC-JP;ptnid=495071102827757095,enc=UTF-8

      この例で、パターン495071102827757094にはタイムゾーンのUTCおよび文字エンコーディングのEUC-JPプロパティが適用され、パターン495071102827757095には文字エンコーディングのプロパティUTF-8が適用されます。

    • 特定のパターンとソースの組合せにのみプロパティを適用します:

      loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,ptnid=495071102827757094,tz=UTC,enc=EUC-JP;srcid=-2574377491167724513,ptnid=495071102827757095,enc=UTF-8

      この例で、タイムゾーンのUTCおよび文字エンコーディングのEUC-JPプロパティはパターン495071102827757094とソース-2574377491167724513を含むログに適用され、文字エンコーディングのプロパティUTF-8はパターン495071102827757095とソース-2574377491167724513を含むログに適用されます。

データベースSQL収集スケジュールの構成

CSVファイルの周期性を次に示す形式で指定することで、各データベース・ログ・ソースのSQL収集スケジュールをカスタマイズできます。

  1. データベース・ホストの管理エージェントまたはOracle Cloud Agentインストール・ディレクトリに移動します(例: agent_inst)。エージェント・インストール・ディレクトリにlaconfigディレクトリを作成します。

  2. laconfigディレクトリにCSVファイルlogan_schedule_database_sql_*.CSVを作成します。これはスケジュール構成ファイルです。

  3. スケジュール構成ファイルで、ソース・スケジュールの詳細を次の形式で指定します:

    NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR
    <Source-Name>,DAY,1,1

    ヘッダー行には、規定されたコンテンツNAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOURが必要です

    後続の行では、各ソースのスケジュールを1行に1つずつ指定します。

    ヘッダー行パラメータとその値:

    ヘッダー行パラメータ 説明 使用可能な値

    NAME

    Oracle Logging Analyticsで定義されたデータベース・ログ・ソースの名前。

    任意

    RECURRENCE_PATTERN_UNIT

    これは、分や日など、SQL収集の頻度単位です。

    WEEKおよびMONTHには、:で区切られた複数の値を指定できます

    • MIN: 分
    • HOUR: 時間
    • DAY: 日
    • WEEK: 週
    • MONTH: 月

    RECURRENCE_PATTERN_VALUE

    選択したパターン・ユニットの値。

    • MIN: 5分、15
    • HOUR: 間隔1時間
    • DAY: 1または12で毎日実行
    • WEEK: SUN, MON, TUE, WED, THU, FRI, SAT
    • MONTH: 日付1から31、月のLAST

    START_HOUR

    SQL収集の開始時間(0100時間または1200時間など)。

    この値を指定しない場合、SQL収集はソースとエンティティの関連付けの直後に開始されます。値が指定されていない場合でも、スケジュールが有効になるには、行に前のカンマが存在する必要があります。

    1または12

  4. CSVファイルを保存した後、エージェントを再起動します。

スケジュール設定の値の例を次に示します。

ソース行コンテンツ 説明

<Source-Name>,MIN,5,

ソースとエンティティのアソシエーション時間から開始して、5分ごとにSQL問合せをスケジュールします。

<Source-Name>,HOUR,1,

ソースとエンティティのアソシエーション時間から開始して、1時間ごとにSQL問合せをスケジュールします。

<Source-Name>,DAY,1,1

SQL問合せを毎日0100時間のシステム時間にスケジュールします。

<Source-Name>,DAY,1,12

SQL問合せを毎日1200時間のシステム時間にスケジュールします。

<Source-Name>,WEEK,FRI,1

SQL問合せを毎週金曜日のシステム時間0100時にスケジュールします。

<Source-Name>,WEEK,WED:THU,1

SQL問合せを毎週水曜日と木曜日のシステム時間0100時にスケジュールします。

<Source-Name>,MONTH,7,1

SQL問合せを毎月日付7の0100時間のシステム時間にスケジュールします。

<Source1-Name>,MIN,5,

<Source2-Name>,DAY,1,1

最初にSource1をエンティティに関連付け、ログ収集が開始されるまで待機してから、Source2と同じエンティティのアソシエーションを追加して構成を更新します

ラージ・フォルダからのログ収集の有効化

デフォルトでは、管理エージェントを使用してログを収集する場合、ファイル数が10000を超えるフォルダから収集は有効になりません。ただし、次の構成変更を行うことで有効にできます。

エージェント・インストール・フォルダの構成プロパティloganalytics.enable_large_dirtrueに手動で編集して、10000を超えるファイルがあるフォルダからログを収集できます。デフォルトでは、プロパティ値はfalseです。

場所agent_inst/config/emd.propertiesのプロパティ・ファイルemd.propertiesを編集し、次のプロパティを追加してOracle Logging Analyticsのデフォルト構成をオーバーライドします:

loganalytics.enable_large_dir=true

ファイルemd.propertiesの編集後に管理エージェントを再起動します。

マクロを使用したログ・ファイル・パスの大/小文字を区別しない一致

ログ・ファイル・パス・パターンで無視大文字と小文字のマクロ(?i)を使用して、大/小文字を区別しない形式で解釈します。これは、「ファイル」タイプのログ・ソースで提供されるログ・ファイル・パス・パターンに適用されます。

マクロ(?i)は、パスの要素の先頭にある場合にのみ適用されます。

次の例を考えてみます。

/tmp/(?i)FOO/*.log

前述の例では、マクロに続くパスの要素はFOOです。これは、大文字と小文字を区別しない形式で解釈されます。

ノート

プロパティーの値にスラッシュ文字 /が含まれている場合は、ignore-caseマクロを正しく使用するように注意してください。たとえば、エンティティ・プロパティがlogdir=/tmp/logs/で、ログ・ソース・ファイルのパス・パターンが(?i){logdir}/foo.logで、無視大文字と小文字のマクロが適用されている場合、ログ・ソース・ファイルのパス・パターンは(?i)/tmp/logs/foo.logとして解釈され、目的の結果ではありません。

このような場合は、大文字と小文字を区別しない複数のプロパティーを追加し、無視大文字と小文字のマクロを使用してそれらのプロパティーからログパターンパスを構築します。