エージェント構成の作成
アプリケーションからカスタム・ログにイベントを取り込むには、Loggingでエージェント構成を作成します。
エージェント構成を作成するには、最初にOracle Fluentdベースのエージェントをインストールする必要があります。詳細は、エージェントのインストールを参照してください。
- ナビゲーション・メニューを開き、「監視および管理」をクリックします。「ロギング」で、「エージェント構成」をクリックします。
- 「リスト範囲」で、作業する権限があるコンパートメントを選択します。
- 「エージェント構成の作成」をクリックします。
- 「エージェント構成の作成」パネルで、構成の名前と説明を入力します。機密情報を入力しないでください。
- 構成を作成するコンパートメントを選択します。
-
「ホスト・グループ」で、この構成に適用する仮想マシンを定義し、「グループ・タイプ」リストから次のいずれかのオプションを選択します。
- 動的グループ: 動的グループは、コンソールのIAM機能で作成できるインスタンスのグループを示します。詳細は、動的グループについてを参照してください。「グループ」リストから動的グループを選択します。
- ユーザー・グループ: ユーザー・グループは、コンソールのIAMグループ機能を指します。詳細は、グループの管理を参照してください。「グループ」リストからユーザー・グループを選択します。
-
別のグループを追加するには、「+別のホスト・グループ」をクリックします。
エージェント構成にグループ・タイプの組合せを追加できます。
ノート
構成ごとに最大5つのグループが許可され、ホストは最大5つの異なるグループに配置できます。 -
「エージェント構成」で、「ログ入力の構成」でログのフォーマット(監視対象のログ)を定義します。「入力タイプ」リストからオプションのいずれかを選択します。
- 「Windowsイベント・ログ」の場合、入力名を入力し、1つ以上のイベント・チャネルを選択します。
- 「ログ・パス」に、入力名と1つ以上のファイル・パスを入力します。たとえば、/<log_path>/<log_name>です。
複数のログ・ファイル・パスをカンマ(、)で区切って指定できます。詳細は、https://docs.fluentd.org/input/tail#pathを参照してください。
<source> @type tail tag 757261.oc_oslogs_linux path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*, var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos path_key tailed_path </source>
構成例:{{path C:\Program Files (x86)\<application>\<directory>*, C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}
-
「Advanced parser options」をクリックし、「Advanced parser options」パネルで、ログの解析方法を指定するパーサーを選択します。一部のパーサーは、選択したタイプによってはさらに入力が必要で、より多くのオプションがあります。
たとえば、JSONの場合、リストから時間タイプの値を選択し、オプションでイベント時間とnullフィールド設定を指定できます。REGEXPの場合、一致するログの正規表現を時間フォーマットとともに指定できます。詳細については、Log Inputs and Parsersを参照してください。重要
特定のパーサー・タイプを指定しない場合でも、NONEパーサー・タイプは必須です。 -
「ログの保存先の選択」で、コンパートメントで選択する構成のユーザー・グループまたは動的グループは、そのコンパートメントで作業する権限が必要です。
対応するリストからログ・グループおよびログ名を選択します。
ログ名は、カスタム・ログのみを指し示し、構成が機能するには、選択したログ・グループにカスタム・ログが存在する必要があります。
- (オプション)「追加オプションの表示」をクリックします。「エージェントの運用メトリックのロギング」で、「有効化」をクリックして、エージェントに関する潜在的な問題をモニターおよび識別できるようにします。
「宛先の発行」で、コンパートメントを選択してネームスペースを指定し、オプションで対応するフィールドからリソース・グループを指定します。ノート
リソース・グループはオプションですが、何も選択されていない場合はデフォルトでdefaultGroupに設定されます。「操作メトリック」で、エージェント構成に対して有効にする操作メトリックを選択します。- ハートビート: 統合モニタリング・エージェントの状態。値1はエージェントが使用可能であることを示し、0はエージェントが応答していないことを示します。このメトリックは常に有効であり、オフにできません。
ディメンション: インスタンスの統合モニタリング・エージェントのバージョン、操作システム、アーキテクチャ、リージョン、ADおよびインスタンスID。
- RestartMetric: 定期的なハートビート・メトリックとは異なり、RestartMetricはエージェントの存続期間中、つまりエージェントの再起動中に1回のみ送信されます。エージェントの安定性を理解するには、再起動の監視が不可欠です。頻繁に再起動すると、システムの不具合を示す可能性があり、予期しない再起動を認識すると、オペレータが構成の問題やリソースの制約に対処するのに役立ちます。
ディメンション: インスタンスID。
- EmitRecords: 発行されたログ・レコードの合計数。レコードは、バックエンドに送信されるログ行に対応します。このメトリックは、取り込まれたログ行数の増加と減少、および処理中のログの量に関するインサイトを提供します。この数値が突然減少または増加すると、ロギング・パイプラインで問題が発生する可能性があります。たとえば、一部のログ行は拒否され、ログの収集中に含まれない場合があります。
ディメンション: インスタンスIDおよびタグ。
- BufferSpaceAvailable: パーセンテージで表される使用可能なバッファ領域。値は100から始まり、バッファ量が使用されると減少します。エージェントはバッファを使用して、受信データのバーストと出力からの潜在的なバックプレッシャーを処理します。このメトリックを監視すると、バッファ領域が不足しないことが保証され、データの損失やバックプレッシャーにつながる可能性があります。バッファ領域が常に少なくなっている場合は、エージェント構成を最適化し、より多くのリソースを割り当てる必要があります。
ディメンション: インスタンスIDおよびタグ。
- ShowFlushCount: 低速フラッシュの合計数。フラッシュとは、バッファ・データを目的の宛先に送信する処理を指します。低速フラッシュとは、バッファから宛先へのデータのフラッシュに、設定したしきい値より時間がかかっていることを意味します。この数は、バッファ・フラッシュが20秒より長くなると増加します。低速フラッシュを監視すると、パフォーマンスの問題の特定に役立ちます。フラッシュが一貫して低速である場合、バッファはデータをクリアできるよりも高速に一杯になり、データの損失やバックプレッシャの問題が発生する可能性があります。
ディメンション: インスタンスIDおよびタグ。
- RollbackCount: バッファを出力先に正常にフラッシュできなかったため、エージェントがトランザクションをロールバックした合計回数。ロールバックは通常、書込みまたはtry_writeが失敗した場合、またはOCI ロギング・サービスの問題、ネットワークの問題または構成の問題が存在する場合に発生します。高いロールバック数は、調査が必要なロギング・パイプラインの信頼性問題の明確なインジケータです。
ディメンション: インスタンスIDおよびタグ。
- RetryCount: 失敗後にエージェントがデータ送信操作を再試行する回数を追跡します。再試行はデータの配信に関する一時的な問題を示し、再試行回数が多いとネットワークが不安定である可能性があります。ロールバックではトランザクションの問題が大きくなる可能性がありますが、多くの場合、再試行では中断が少なくなり、頻繁に発生する可能性があります。
ディメンション: インスタンスIDおよびタグ。
エージェント構成の作成後、エージェント構成の詳細の取得時に有効になっている操作メトリックを表示できます。
- ハートビート: 統合モニタリング・エージェントの状態。値1はエージェントが使用可能であることを示し、0はエージェントが応答していないことを示します。このメトリックは常に有効であり、オフにできません。
- (オプション)「追加オプションの表示」をクリックします。「タグの追加」で、必要に応じてタグを追加します。
- (オプション)「スタックとして保存」をクリックして、リソース構成をスタックとして保存します。
詳細は、リソース作成ページからのスタックの作成を参照してください。
- 「作成」をクリックします。
エージェント構成が作成され、「エージェント構成」ページに表示されます。 oci logging agent-configuration createコマンドおよび必須パラメータを使用して、ロギング用のエージェント構成を作成します:
oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]
CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。
CreateUnifiedAgentConfiguration操作を実行して、ロギング用のエージェント構成を作成します。