2.3. 初期設定

手順

1. ナビゲーションパネルから、Settings Automation Execution Logging を選択します。
2. Logging settings ページで、Edit をクリックします。

3. 以下のオプションを設定できます。

   • Logging Aggregator: ログを送信するホスト名または IP アドレスを入力します。

   • Logging Aggregator Port: アグリゲーターのポートが必要な場合は、ポートを指定します。

     注記

     接続タイプが HTTPS の場合、ホスト名をポート番号付きの URL として入力できます。その後はポートを再度入力する必要はありません。ただし、TCP 接続と UDP 接続は、URL ではなく、ホスト名とポート番号の組み合わせによって特定されます。したがって、TCP 接続または UDP 接続の場合は、指定されたフィールドでポートを指定します。代わりに URL が Logging Aggregator フィールドに入力された場合、そのホスト名部分がホスト名として抽出されます。

   • Logging Aggregator Type: クリックして、リストからアグリゲータサービスを選択します。
   • Logging Aggregator Username: 必要に応じて、ロギングアグリゲーターのユーザー名を入力します。
   • Logging Aggregator Password/Token: 必要に応じて、ロギングアグリゲーターのパスワードを入力します。
   • Loggers to Send Data to the Log Aggregator Form: デフォルトでは、4 種類のデータすべてが事前に入力されています。各データ型の追加情報を表示するには、フィールドの横にあるツールチップアイコン をクリックします。不要なデータ型を削除します。
   • Cluster wide unique identifier: これを使用してインスタンスを一意に識別します。
   • Logging Aggregator Protocol: クリックして、ログアグリゲーターと通信するための接続タイプ (プロトコル) を選択します。その後に表示されるオプションは、選択したプロトコルによって異なります。
   • TCP Connection Timeout: 接続タイムアウトを秒単位で指定します。このオプションは、HTTPS および TCP ログアグリゲータープロトコルにのみ適用されます。
   • Logging Aggregator Level Threshold: ログハンドラーで報告する重大度のレベルを選択します。
   • Maximum number of messages that can be stored in the log action queue: 保存されるメッセージの数に応じて rsyslog アクションキューがどれだけ大きくなるかを定義します。これはメモリー使用量に影響を及ぼす可能性があります。キューがこの数の 75% に達すると、キューはディスクへの書き込みを開始します (rsyslog の queue.highWatermark)。90% に達すると、NOTICE、INFO、および DEBUG メッセージが破棄され始めます (queue.discardMark と queue.discardSeverity=5)。
   • Maximum disk persistence for rsyslogd action queuing (in GB): rsyslog アクションによる受信メッセージの処理に時間がかかる場合 (デフォルトは 1) に、保存するデータ量 (ギガバイト単位) です。アクションの rsyslogd queue.maxdiskspace 設定と同等です (例: omhttp)。これは、LOG_AGGREGATOR_MAX_DISK_USAGE_PATH で指定されたディレクトリーにファイルを保存します。
   • File system location for rsyslogd disk persistence: 外部ログアグリゲーターの停止後に再試行する必要のあるログを永続化する場所 (デフォルトは /var/lib/awx)。rsyslogd queue.spoolDirectory 設定に相当します。
   • Log Format For API 4XX Errors: 特定のエラーメッセージを設定します。詳細は、API 4XX エラー設定 を参照してください。

手順

1. ゲートウェイ設定ファイルを編集します。

   1. Ansible Automation Platform 2.5 コンテナー版の場合、ファイルは ~/aap/gateway/etc/settings.py です (プラットフォームゲートウェイコンテナーを実行しているユーザーとして編集します)。

   2. Ansible Automation Platform 2.5 RPM 版の場合、ファイルは /etc/ansible-automation-platform/gateway/settings.py です。

       (...)
        CACHES['fallback']['LOCATION'] = '/var/cache/ansible-automation-platform/gateway'
      
        LOGGING['loggers']['aap']['level'] = 'INFO'
        LOGGING['loggers']['ansible_base']['level'] = 'INFO'
        LOGGING['loggers']['django_auth_ldap']['level'] = 'DEBUG'      ######      add this line
      
        (...)

2. プラットフォームゲートウェイのサービスまたはコンテナーを再起動します。

   1. Ansible Automation Platform 2.5 コンテナー版の場合、プラットフォームゲートウェイサービスを再起動して、プラットフォームゲートウェイコンテナーを再起動します。

      注記

      次のように `--user` フラグを指定して systemctl を実行してください。

      + $ systemctl --user restart automation-gateway

   2. Ansible Automation Platform 2.5 RPM 版の場合、automation-gateway-service コマンドを使用します。

      # automation-gateway-service restart

手順

1. Automation Controller に管理者としてログインします。
2. ナビゲーションパネルから、Settings Automation Execution Logging を選択します。
3. Logging settings ページで、Edit をクリックします。

4. 以下のフィールドを設定します。

   • Logging Aggregator を Not configured に設定します。これはデフォルトです。
   • Enable External Logging を On に設定します。
   • Logging Aggregator Level Threshold を DEBUG に設定します。
   • TCP Connection Timeout を 5 (デフォルト) または組織のタイムアウトに設定します。
   • Enable/disable HTTPS certificate verification を On に設定します。
5. Save をクリックします。

1. 障害の原因がログレコードのストレージ容量の不足である場合、アプリケーションは可能であればログレコードの生成を続行し (必要に応じてログサービスを自動的に再起動し)、最も古いログレコードを先入れ先出し方式で上書きする必要があります。

2. ログレコードが一元収集サーバーに送信され、このサーバーとの通信が失われるかサーバーに障害が発生した場合、通信が回復するかログレコードが手動で取得されるまで、アプリケーションはログレコードをローカルでキューに入れる必要があります。一元収集サーバーへの接続が回復したら、ローカルログデータを収集サーバーと同期するためのアクションを実行する必要があります。

   このセキュリティー制御を実装するには、次の手順を実行します。

   1. Web ブラウザーを開き、ロギング API(/api/v2/settings/logging/) に移動します。

      Automation Controller 管理者として認証されていることを確認します。

   2. Content セクションで、次の値を変更します。

      • LOG_AGGREGATOR_ACTION_MAX_DISK_USAGE_GB = ログバッファリングに関する組織定義の要件。
      • LOG_AGGREGATOR_MAX_DISK_USAGE_PATH = /var/lib/awx .. PUT をクリックします

手順

1. 各 Automation Controller ホストのシステム管理者として、Automation Controller NGINX ログディレクトリーの権限と所有者を設定します。

   • chmod 770 /var/log/nginx
   • chown nginx:root /var/log/nginx

2. Automation Controller ログディレクトリーの権限と所有者を設定します。

   • chmod 770 /var/log/tower
   • chown awx:awx /var/log/tower

3. Automation Controller スーパーバイザーログディレクトリーの権限と所有者を設定します。

   • chmod 770 /var/log/supervisor/
   • chown root:root /var/log/supervisor/