コンソールを使用して、様々な階層レベル(テナント・レベルが最高)でLog Analyticsログ収集のエージェント・プロパティを設定できます。

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

このタスクは、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 Log 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 Log Analyticsで定義されたデータベース・ログ・ソースの名前。	いずれか
   RECURRENCE_PATTERN_UNIT	これは、分や日など、SQL収集の間隔の単位です。 WEEKおよびMONTHには、:で区切られた複数の値を指定できます。	MIN: 分 時間: 時間 DAY: 日 週: 週 月: 月
   RECURRENCE_PATTERN_VALUE	選択したパターン単位の値。	MIN: 間隔5分、15分 HOUR: 間隔1時間 DAY: 毎日1または12で実行 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT 月: 日付1から31、月のLAST日
   START_HOUR	SQL収集の開始時間(0100時間、1200時間など)。 この値を指定しない場合、SQL収集はソースとエンティティの関連付けの直後に開始されます。値を指定しない場合でも、スケジュールが有効になるには、先行するカンマが行に存在する必要があります。	1または12。

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

スケジュール構成の値の例の一部を次に示します。

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

管理エージェントLog Analyticsプラグインで大きなフォルダが検出されると、次の例のようなメッセージが管理エージェント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です。

agent_inst/config/emd.propertiesの場所にあるプロパティ・ファイルemd.propertiesを編集し、前述のプロパティ値を追加してOracle Log 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ノードが使用可能であることを確認します。これは、使用するログ・ソースおよびパーサーのタイプによって異なります。パーサーがHeader-Detail関数を使用する場合、元のログ・ファイルが存在しているかぎり、エージェントはヘッダーを作成してキャッシュ・ファイルに格納します。
• 開いているファイルの数のオペレーティング・システム設定が、大きいフォルダおよび潜在的に多数の状態ファイルを読み取る管理エージェントをサポートできることを確認します。

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

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

例を考えてみます。

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

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