コンソールを使用して、ロギング・アナリティクスのログ・コレクションのエージェント・プロパティを様々な階層レベル(テナント・レベルが最高)で設定できます。

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

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

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

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

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

     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つずつスケジュールを指定します。

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

   ヘッダー行パラメータ	説明	許可された値
   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ノードが使用可能であることを確認します。これは、使用されるログ・ソースおよびパーサーのタイプによって異なります。パーサーがヘッダー詳細関数を使用する場合、元のログ・ファイルが存在するかぎり、エージェントはヘッダーを作成してキャッシュ・ファイルに格納します。
• 開いているファイルの数のオペレーティング・システム設定で、大きいフォルダおよび多数の状態ファイルの読取りを管理エージェントがサポートできることを確認します。

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

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

次の例を考えてみます。

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

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