gavika.aws_cloudwatchagent

Ansible Rolle: AWS CloudWatch Agent

Diese Ansible Rolle installiert und konfiguriert den AWS CloudWatch Agent auf AWS EC2-Instanzen und On-Premise-Servern.

Anforderungen

  • Eine AWS EC2-Instanz oder ein On-Premise-Linux-Server
  • Wenn Sie eine AWS EC2-Instanz verwenden, muss die Instanz über eine angehängte IAM-Rolle verfügen, die Berechtigungen zum Ausführen des AWS CloudWatch Agent hat. Ziehen Sie die von AWS bereitgestellte Richtlinie - CloudWatchAgentServerPolicy - in Betracht.
  • Wenn Sie einen On-Premise-Server verwenden, konfigurieren Sie /root/.aws/credentials und /root/.aws/config.
  • Stellen Sie die YAML-Variable aws_cloudwatch_agent_config bereit. Diese wird in JSON umgewandelt. Weitere Informationen finden Sie in defaults/main.yml für eine grundlegende Konfiguration.

Variablen der Rolle

Variable Standardwert Beschreibung Erforderlich?
aws_cloudwatch_agent_username Der Administrationsbenutzer, der Eigentümer der heruntergeladenen Dateien sein soll. In der Regel derselbe wie remote_user. Auf Ubuntu könnte das ubuntu sein, auf CentOS centos und auf Amazon Linux ec2-user. Die Rolle schätzt den Benutzernamen basierend auf dem Betriebssystem, wenn er nicht explizit festgelegt ist. Nein
aws_cloudwatch_agent_download_directory Der Ort, an dem die AWS CloudWatch Agent-Software heruntergeladen werden soll. Die Rolle schätzt den Speicherort basierend auf dem Betriebssystem, wenn er nicht explizit festgelegt ist. Nein
aws_cloudwatch_agent_download_url Die URL, von der der Amazon CloudWatch Agent heruntergeladen werden muss. Diese wird automatisch von der Rolle festgelegt, kann aber überschrieben werden. Nein
aws_cloudwatch_agent_mode ec2 Der Modus des AWS CloudWatch Agent. Kann ec2, onPremise oder auto sein. Nein

Beispiel für eine JSON-Datei: aws-cw-config.json

agent:
    metrics_collection_interval: 60
    run_as_user: "cwagent"
metrics:
    namespace: "Gavika"
    append_dimensions:
      InstanceId: "${aws:InstanceId}"
    metrics_collected:
      disk:
        measurement:
          - used_percent
        metrics_collection_interval: 60
        resources:
          - "*"
      mem:
        measurement:
          - mem_used_percent
        metrics_collection_interval: 60

Beispiel für /root/.aws/credentials für On-Premise-Server:

[AmazonCloudWatchAgent]
aws_access_key_id = youraccesskeyid
aws_secret_access_key = yoursecretkey

Beispiel für /root/.aws/config für On-Premise-Server:

[AmazonCloudWatchAgent]
region = us-east-1

Für die Liste der Metriken siehe AWS CloudWatchAgent-Dokumentation

Beispiel-Playbook

    - hosts: cloudwatch-servers
      roles:
         - role: Gavika.aws-cloudwatch-agent

Kontinuierliche Integration

Sie können Molekül-Tests lokal ausführen.

Lizenz

Apache2

Autoreninformationen

Sudheer Satyanarayana

Gavika

Über das Projekt

Install and configure AWS CloudWatch Agent

Installieren
ansible-galaxy install gavika.aws_cloudwatchagent
GitHub Repository
Lizenz
Unknown
Downloads
285