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

このタスクは、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. プロパティ・ファイルemd.propertiesをagent_inst/config/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を含むログに適用されます。

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ファイルを保存した後、エージェントを再起動します。

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

10,000を超えるファイルを含むフォルダでは、管理エージェントによるリソース(メモリー/ストレージ/CPU)使用率が高いことが原因で、ログ収集が遅くなり、管理エージェントの他の機能に影響し、ホスト・マシンの速度が低下する可能性があります。

管理エージェント・ログ・分析プラグインで大きなフォルダが検出されると、次の例のようなメッセージが管理エージェントmgmt_agent_logan.logファイルに追加されます:

2020-07-30 14:46:51,653 [LOG.Executor.2388 (LA_TASK_os_file)-61850] INFO - ignore large dir /u01/service/database/logs. set property loganalytics.enable_large_dir to enable.

ただし、大きなフォルダのログのモニタリングを続行する場合は、次の変更を加えてサポートを有効にできます。

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

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

sudo -u mgmt_agent echo "loganalytics.enable_large_dir=true" >> INSTALL_DIRECTORY/agent_inst/config/emd.properties

INSTALL_DIRECTORYをagent_instフォルダのパスに置き換えます。ファイルemd.propertiesの編集後に管理エージェントを再起動します。

このサポートを有効にするには、ホスト・エージェントでいくつかの構成変更を行う必要がある場合があります。本番環境で新しい設定を作成する前に、開発環境またはテスト環境で新しい設定を試してください。代表的な環境を使用して、次の要因の増大を確認します。実際の必要な増加は、ファイル数、ファイル作成率、管理エージェントが実行しているその他のタイプの収集などの要因によって異なります。

• 管理エージェントのヒープ・サイズを増やします。ファイル数が多いディレクトリの場合、必要なヒープ・サイズはファイル数とともに増加します。管理エージェントのドキュメントを参照してください。
• 管理エージェントが保持する必要がある多数の状態ファイルの処理に十分なディスク領域およびiノードが使用可能であることを確認します。これは、使用されるログ・ソースおよびパーサーのタイプによって異なります。パーサーがヘッダー詳細関数を使用する場合、元のログ・ファイルが存在するかぎり、エージェントはヘッダーを作成してキャッシュ・ファイルに格納します。
• 開いているファイルの数のオペレーティング・システム設定で、大きいフォルダおよび多数の状態ファイルの読取りを管理エージェントがサポートできることを確認します。

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

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

次の例を考えてみます。

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

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