ログの作成

• コンソール
• CLI
• API

• ログ・グループは、ログを編成するための論理コンテナです。ログは、常にログ・グループ内に存在する必要があります。ログを作成する前にログ・グループを作成する必要があります。

  ログおよびその操作に必要な権限の詳細は、ログ・グループの管理を参照してください。

  1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「ロギング」で、「ログ」をクリックします。
  2. 「リスト範囲」で、操作する権限があるコンパートメントを選択します。
  3. 「カスタム・ログの作成」をクリックします。
  4. 「カスタム・ログの作成」ページで、カスタム・ログの名前を入力します。機密情報を入力しないでください。
  5. 「コンパートメント」から、ログインするコンパートメントを選択します。
  6. 「ログ・グループ」で、カスタム・ログを配置するログ・グループを選択します。
  7. オプションで、「追加オプションの表示」をクリックし、次の値を指定します:
     • 「ログ保持」で、最大180日までの30日間の増分でログを保持する時間を選択します。
       ノート
       
       

       保持期間を6か月から1か月に変更すると、1か月より古いすべてのログにアクセスできなくなります。たとえば、1か月から6か月に変更した場合、ログは1か月後に使用できず、6か月の古いログは使用できません。

       さらに、ログが使用できなくなる将来の日時は、ログを作成した正確な日時に基づきます。たとえば、7月21日の15:05 UTCに3か月の保存期間でログを作成した場合、10月19日の15:05にログは検索できなくなります。

     • 「タグの追加」で、タグ・ネームスペース(定義済タグの場合)、キーおよび値を入力して、1つ以上のタグをログに追加します。
  8. 「カスタム・ログの作成」をクリックします。
     「エージェント構成の作成」ページで、新しい構成を作成して、関連するログ・データのパラメータを定義したり(デフォルト)、後でそれを追加したりできます。エージェント構成では、構成を適用するインスタンス(ホスト・グループ)、取得するログ・ファイルおよび使用するパーサー(ある場合) (ログ入力の構成)を定義します。

     • 「新規構成の作成」を選択した場合は、次のステップに進みます。
     • 「後で構成を追加」を選択した場合は、ステップ16にスキップします。
  9. 構成の名前と説明を入力します。機密情報を入力しないでください。
  10. 構成を作成するコンパートメントを選択します。
  11. この構成に適用するVMを定義する「ホスト・グループ」で、「グループ・タイプ」リストから次のいずれかのオプションを選択します。
      • 動的グループ: 動的グループは、コンソールのIAM機能で作成できるインスタンスのグループを示します。詳細は、動的グループについてを参照してください。「グループ」リストから動的グループを選択します。
      • ユーザー・グループ: ユーザー・グループは、コンソールのIAMグループ機能を参照します。詳細は、グループの管理を参照してください。「グループ」リストからユーザー・グループを選択します。
  12. 別のグループを追加するには、「+別のホスト・グループ」をクリックします。

      エージェント構成にグループ・タイプの組合せを追加できます。

      ノート
      
      構成ごとに最大5つのグループが許可され、ホストは最大5つの異なるグループに配置できます。
  13. 「エージェント構成」で、ログ入力の構成でログのフォーマット(監視するログ)を定義します。「入力タイプ」リストから、次のいずれかのオプションを選択します。
      • 「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>* }}

      「+別のログ入力」をクリックして、カスタム・ログ入力をさらに追加します。

  14. 「高度なパーサー・オプション」をクリックし、「高度なパーサー・オプション」パネルで、ログの解析方法を指定するパーサーを選択します。一部のパーサーは、選択したタイプによってはさらに入力が必要で、より多くのオプションがあります。

      たとえば、JSONの場合、リストから時間タイプの値を選択し、オプションでイベント時間とnullフィールド設定を指定できます。REGEXPの場合、一致するログの正規表現を時間フォーマットとともに指定できます。詳細については、Log Inputs and Parsersを参照してください。

      重要
      
      特定のパーサー・タイプを指定しない場合でも、NONEパーサー・タイプは必須です。
  15. ログ入力およびパーサーを構成したら、オプションでタグ設定を指定できます。
  16. 「エージェント構成の作成」をクリックします。

      カスタム・ログ・オブジェクトが、関連付けられたエージェント構成(指定されている場合)とともに作成され、インスタンスからデータがプルされて、カスタム・ログ・オブジェクトにプッシュされます。

• oci logging log createコマンドおよび必須パラメータを使用して、ログ・グループにログを作成します:

  oci logging log create --display-name display_name --log-group-id log_group_ocid --log-type log_type [OPTIONS]

  CLIコマンドのパラメータおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

• CreateLog操作を実行して、ログ・グループにログを作成します。