CloudWatchログ

このロールは、UbuntuマシンにCloudWatch Logsエージェントをインストールします。

要件

AWSの認証情報がマシンにすでに設定されている必要があります。これはIAMロールやAWS CLI設定のグローバルIAMユーザー認証情報で動作します（詳細は こちら を参照）。

ロール変数

cw_server_type: <ec2 | onPremise>

この変数は、エージェントがEC2インスタンス内にインストールされているか、オンプレミスサーバーにインストールされているかを定義します。デフォルトは ec2 です。

aws_region: us-east-1

これは、インスタンスモードがEC2でない場合に使用するAWSリージョンを定義します。

cw_logs_files: []

これは最も重要な変数で、管理したいログの設定を定義します。エージェントが監視するログのリストを期待します。このリストは次のフォーマットに従います。

cw_logs_files:
  - log_group_name: /var/log/syslog
    log_stream_name: '{hostname}-{instance_id}'
    timestamp_format: '%b %d %H:%M:%S'
    file_path: /var/log/syslog
    encoding: utf-8
  - log_group_name: /var/log/auth.log
    log_stream_name: '{hostname}-{instance_id}'
    timestamp_format: '%b %d %H:%M:%S'
    file_path: /var/log/auth.log
    encoding: utf-8

nameフィールドはログエントリの名前を定義します。これはユニークである必要があります。argsフィールドには、AWSのドキュメントに基づいたログ設定の詳細が含まれている必要があります。詳細はこちらをご覧ください。

依存関係

なし

例プレイブック

- hosts: all
  roles:
    - role: jobscore.cloudwatch-logs
      cw_server_type: onPremise
      aws_region: us-east-1
      cw_logs_files:
        - log_group_name: /var/log/syslog
          log_stream_name: '{hostname}-{instance_id}'
          timestamp_format: '%b %d %H:%M:%S'
          file_path: /var/log/syslog
          encoding: utf-8
        - log_group_name: /var/log/auth.log
          log_stream_name: '{hostname}-{instance_id}'
          timestamp_format: '%b %d %H:%M:%S'
          file_path: /var/log/auth.log
          encoding: utf-8

ライセンス

GPLv3

著者情報

このロールは、Eric Magalhães と Glauber Batista によって、JobScore Incでの作業中に作成されました。