管理エージェントの拡張構成オプション
管理エージェント構成を変更してログ収集をカスタマイズできるユースケースを次に示します。
ファイルのタイムゾーンおよび文字エンコーディングの手動指定
エージェント・インストール・フォルダの構成プロパティを編集して、ログ・ファイルのプロパティを手動で指定できます。
このタスクは、Windowsイベント以外のすべてのログに対して実行できます。
-
特定のパターンまたはログ・ソース(あるいはその両方)にプロパティを適用する場合、そのパターン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です。
- パターンIDの例:
-
場所agent_inst/config/emd.propertiesのプロパティ・ファイルemd.propertiesを編集し、次のプロパティを追加してOracle Logging Analyticsのデフォルト構成をオーバーライドします:
loganalytics.src.override_config=true
-
次のいずれかの例から選択して、ファイル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収集スケジュールをカスタマイズできます。
-
データベース・ホストの管理エージェントまたはOracle Cloud Agentインストール・ディレクトリに移動します(例:
agent_inst
)。エージェント・インストール・ディレクトリにlaconfig
ディレクトリを作成します。 -
laconfig
ディレクトリにCSVファイルlogan_schedule_database_sql_*.CSV
を作成します。これはスケジュール構成ファイルです。 -
スケジュール構成ファイルで、ソース・スケジュールの詳細を次の形式で指定します:
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。
-
CSVファイルを保存した後、エージェントを再起動します。
スケジュール設定の値の例を次に示します。
ソース行コンテンツ | 説明 |
---|---|
|
ソースとエンティティのアソシエーション時間から開始して、5分ごとにSQL問合せをスケジュールします。 |
|
ソースとエンティティのアソシエーション時間から開始して、1時間ごとにSQL問合せをスケジュールします。 |
|
SQL問合せを毎日0100時間のシステム時間にスケジュールします。 |
|
SQL問合せを毎日1200時間のシステム時間にスケジュールします。 |
|
SQL問合せを毎週金曜日のシステム時間0100時にスケジュールします。 |
|
SQL問合せを毎週水曜日と木曜日のシステム時間0100時にスケジュールします。 |
|
SQL問合せを毎月日付7の0100時間のシステム時間にスケジュールします。 |
|
最初にSource1をエンティティに関連付け、ログ収集が開始されるまで待機してから、Source2と同じエンティティのアソシエーションを追加して構成を更新します |
ラージ・フォルダからのログ収集の有効化
デフォルトでは、管理エージェントを使用してログを収集する場合、ファイル数が10000を超えるフォルダから収集は有効になりません。ただし、次の構成変更を行うことで有効にできます。
エージェント・インストール・フォルダの構成プロパティloganalytics.enable_large_dir
をtrue
に手動で編集して、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
として解釈され、目的の結果ではありません。
このような場合は、大文字と小文字を区別しない複数のプロパティーを追加し、無視大文字と小文字のマクロを使用してそれらのプロパティーからログパターンパスを構築します。