Erstellen oder bearbeiten Sie die CloudWatch Agenten-Konfigurationsdatei manuell - Amazon CloudWatch
Manuelles Speichern der AgentenkonfigurationsdateiLaden Sie die CloudWatch Agentenkonfigurationsdatei in den Systems Manager Parameter Store hoch

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen oder bearbeiten Sie die CloudWatch Agenten-Konfigurationsdatei manuell

Die CloudWatch Agenten-Konfigurationsdatei ist eine JSON-Datei mit vier Abschnitten: agentmetrics,logs, undtraces.

  • Der Abschnitt agent enthält Felder für die allgemeine Konfiguration des Agenten.

  • metricsIn diesem Abschnitt werden die benutzerdefinierten Metriken für die Erfassung und Veröffentlichung angegeben CloudWatch. Wenn Sie den Agenten nur verwenden, um Protokolle zu erfassen, können Sie den Abschnitt metrics in der Datei weglassen.

  • logsIn diesem Abschnitt wird angegeben, welche Protokolldateien in CloudWatch Logs veröffentlicht werden. Hierbei kann es sich u. a. um Ereignisse aus dem Windows-Ereignisprotokoll handeln, wenn auf dem Server Windows Server ausgeführt wird.

  • tracesIn diesem Abschnitt werden die Quellen für Traces angegeben, die gesammelt und an sie gesendet werden AWS X-Ray.

In diesem Abschnitt werden die Struktur und die Felder der CloudWatch Agentenkonfigurationsdatei erläutert. Sie können die Schemadefinition für diese Konfigurationsdatei anzeigen. Die Schemadefinition befindet sich installation-directory/doc/amazon-cloudwatch-agent-schema.json auf Linux-Servern und auf Servern, installation-directory/amazon-cloudwatch-agent-schema.json auf denen Windows Server ausgeführt wird.

Wenn Sie die -Agentenkonfigurationsdatei manuell erstellen oder bearbeiten, können Sie ihr einen beliebigen Namen geben. Zur Vereinfachung der Fehlerbehebung wird empfohlen, ihr auf Linux-Servern den Namen /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json und auf Servern, auf denen Windows Server ausgeführt wird, den Namen $Env:ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json zu geben. Anschließend können Sie die Datei auf andere Server kopieren, auf denen der Agent installiert werden soll.

Anmerkung

Für Metriken, Protokolle und Traces, die vom CloudWatch Agenten erfasst werden, fallen Gebühren an. Weitere Informationen zur Preisgestaltung finden Sie unter CloudWatch Amazon-Preise.

Der Abschnitt agent kann die folgenden Felder enthalten: Der Assistent erstellt keinen Abschnitt agent. Stattdessen lässt der Assistent diesen weg und verwendet die Standardwerte für alle Felder in diesem Abschnitt.

  • metrics_collection_interval – Optional. Gibt an, wie oft alle in dieser Konfigurationsdatei angegebenen Metriken erfasst werden. Sie können den Wert für bestimmte Arten von Metriken überschreiben.

    Der Wert wird in Sekunden angegeben. Beispiel: Angeben, dass 10 Metriken alle 10 Sekunden und 300 Metriken alle 5 Minuten gesammelt werden sollen.

    Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen zu hochauflösenden Metriken finden Sie unter Hochauflösende Metriken.

    Der Standardwert lautet 60.

  • region— Gibt die Region an, die für den CloudWatch Endpunkt verwendet werden soll, wenn eine EC2 Amazon-Instance überwacht wird. Die gesammelten Metriken werden an diese Region gesendet, wie z. B. us-west-1. Wenn Sie dieses Feld weglassen, sendet der Agent Metriken an die Region, in der sich die EC2 Amazon-Instance befindet.

    Wenn Sie einen On-Premises-Server überwachen, wird dieses Feld nicht verwendet, und der Agent liest die Region aus dem AmazonCloudWatchAgent-Profil der AWS -Konfigurationsdatei.

  • credentials— Gibt eine IAM-Rolle an, die beim Senden von Metriken, Protokollen und Traces an ein anderes AWS Konto verwendet werden soll. Sofern angegeben, enthält dieses Feld einen Parameter, role_arn.

  • debug – Optional. Gibt an, dass der CloudWatch Agent mit Debug-Protokollmeldungen ausgeführt wird. Der Standardwert ist false.

  • aws_sdk_log_level – Optional. Wird nur in den Versionen 1.247350.0 und höher des Agenten unterstützt. CloudWatch

    Sie können dieses Feld angeben, damit der Agent die Protokollierung für AWS SDK-Endpunkte durchführt. Der Wert für dieses Feld kann eine oder mehrere der folgenden Optionen enthalten. Trennen Sie mehrere Optionen mit dem |-Zeichen.

    • LogDebug

    • LogDebugWithSigning

    • LogDebugWithHTTPBody

    • LogDebugRequestRetries

    • LogDebugWithEventStreamBody

    Weitere Informationen zu diesen Optionen finden Sie unter LogLevelType.

  • logfile— Gibt den Ort an, an dem der CloudWatch Agent Protokollnachrichten schreibt. Wenn Sie eine leere Zeichenfolge angeben, wird das Protokoll in stderr abgelegt. Wenn Sie diese Option nicht angeben, lauten die Standardspeicherorte folgendermaßen:

    • Linux: /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log

    • Windows Server: c:\\ProgramData\\Amazon\\CloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log

    Der CloudWatch Agent rotiert die von ihm erstellte Protokolldatei automatisch. Eine Protokolldatei wird rotiert, wenn sie eine Größe von 100 MB erreicht. Der Agent bewahrt die rotierten Protokolldateien bis zu sieben Tage lang auf, und er behält bis zu fünf Backup-Protokolldateien, die ausgelagert werden. Die Dateinamen der Sicherungen von Protokolldateien werden um einen Zeitstempel ergänzt. Der Zeitstempel gibt das Datum und die Uhrzeit der Rotation an, z. B. amazon-cloudwatch-agent-2018-06-08T21-01-50.247.log.gz.

  • omit_hostname – Optional. Standardmäßig wird der Hostname als Dimension von Metriken veröffentlicht, die vom Agenten erfasst werden, es sei denn, Sie verwenden das append_dimensions-Feld im metrics-Abschnitt. Setzen Sie omit_hostname auf true, um zu verhindern, dass der Hostname als Dimension veröffentlicht wird, auch wenn Sie append_dimensions nicht verwenden. Der Standardwert ist false.

  • run_as_user – Optional. Gibt einen Benutzer an, der zum Ausführen des CloudWatch Agenten verwendet werden soll. Wenn Sie diesen Parameter nicht angeben, wird der Root-Benutzer verwendet. Diese Option ist nur auf Linux-Servern gültig.

    Wenn Sie diese Option angeben, muss der Benutzer vorhanden sein, bevor Sie den CloudWatch Agenten starten. Weitere Informationen finden Sie unter Den CloudWatch Agenten unter einem anderen Benutzer ausführen.

  • user_agent – Optional. Gibt die user-agent Zeichenfolge an, die vom CloudWatch Agenten verwendet wird, wenn er API-Aufrufe an das CloudWatch Backend tätigt. Der Standardwert ist eine Zeichenfolge, die aus der Agentenversion, der Version der Go-Programmiersprache, die zum Kompilieren des Agenten verwendet wurde, dem Laufzeitbetriebssystem und der Architektur, der Buildzeit und den aktivierten Plugins besteht.

  • usage_data Optional. Standardmäßig sendet der CloudWatch Agent Integritäts- und Leistungsdaten über sich selbst an, CloudWatch wann immer er Metriken oder Protokolle veröffentlicht. CloudWatch Für diese Daten entstehen Ihnen keine Kosten. Sie können verhindern, dass der Agent diese Daten sendet, indem Sie false für usage_data angeben. Wenn Sie diesen Parameter weglassen, wird der Standard von true verwendet, und der Agent sendet die Zustands- und Leistungsdaten.

    Wenn Sie diesen Wert auf false setzen, müssen Sie den Agenten beenden und neu starten, damit die Änderung wirksam wird.

  • service.name Optional. Gibt den Dienstnamen an, der verwendet werden soll, um die Entität für die Suche nach verwandter Telemetrie aufzufüllen.

  • deployment.environment Optional. Gibt den Umgebungsnamen an, der verwendet werden soll, um die Entität für die Suche nach verwandter Telemetrie aufzufüllen.

Es folgt ein Beispiel für den Abschnitt agent.

"agent": {
   "metrics_collection_interval": 60,
   "region": "us-west-1",
   "logfile": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
   "debug": false,
   "run_as_user": "cwagent"
  }

Felder, die Linux und Windows gemeinsam haben

Auf Servern mit Linux oder Windows Server enthält der Abschnitt metrics die folgenden Felder:

  • namespace – Optional. Der Namespace für die vom Agent zu erfassenden Metriken. Der Standardwert ist CWAgent. Die maximale Länge beträgt 255 Zeichen. Im Folgenden wird ein Beispiel gezeigt:

    {
  "metrics": {
    "namespace": "Development/Product1Metrics",
   ......
   },
}

  • append_dimensions – Optional. Fügt allen vom Agenten gesammelten Metriken EC2 Amazon-Kennzahlen hinzu. Dies bewirkt auch, dass der Agent den Hostnamen nicht als Dimension veröffentlicht.

    Die einzigen unterstützten Schlüssel-Wert-Paare für append_dimensions werden in der folgenden Liste angezeigt. Alle anderen Schlüssel-Wert-Paare werden ignoriert. Der Agent unterstützt diese Schlüssel-Wert-Paare genau so, wie sie in der folgenden Liste aufgeführt sind. Sie können die Schlüsselwerte nicht ändern, um unterschiedliche Dimensionsnamen für sie zu veröffentlichen.

    • "ImageId":"${aws:ImageId}" legt die AMI-ID der Instance als Wert der ImageId-Dimension fest.

    • "InstanceId":"${aws:InstanceId}" legt die Instance-ID der Instance als Wert der InstanceId-Dimension fest.

    • "InstanceType":"${aws:InstanceType}" legt den Instance-Typ der Instance als Wert der InstanceType-Dimension fest.

    • "AutoScalingGroupName":"${aws:AutoScalingGroupName}" legt den Namen der Auto Scaling-Gruppe der Instance als Wert der AutoScalingGroupName-Dimension fest.

    Wenn Sie Dimensionen an Metriken mit beliebigen Schlüssel-Wert-Paaren anfügen möchten, verwenden Sie den Parameter append_dimensions im Feld für diesen bestimmten Metriktyp.

    Wenn Sie einen Wert angeben, der von EC2 Amazon-Metadaten abhängt, und Sie Proxys verwenden, müssen Sie sicherstellen, dass der Server auf den Endpunkt für Amazon zugreifen kann. EC2 Weitere Informationen zu diesen Endpunkten finden Sie unter Amazon Elastic Compute Cloud (Amazon EC2) in der Allgemeine Amazon Web Services-Referenz.

  • aggregation_dimensions – Optional. Gibt die Dimensionen an, in denen erfasste Metriken aggregiert werden sollen. Beispiel: Wenn Sie Metriken in der AutoScalingGroupName-Dimension zusammenführen, werden die Metriken aus allen Instances in der jeweiligen Auto-Scaling-Gruppe aggregiert und können als Ganzes angezeigt werden.

    Sie können Metriken in einer einzelnen oder in mehreren Dimensionen zusammenfassen. Beispiel: Wenn Sie [["InstanceId"], ["InstanceType"], ["InstanceId","InstanceType"]] festlegen, werden Metriken für die Instance-ID einzeln, den Instance-Typ einzeln und für die Kombination der beiden Dimensionen aggregiert.

    Sie können auch [] angeben, um alle Metriken in einer Sammlung ungeachtet jeglicher Dimensionen zusammenzufassen.

  • endpoint_override – Gibt einen FIPS-Endpunkt oder einen privaten Link an, der als Endpunkt verwendet wird, an den der Agent Metriken sendet. Wenn Sie dies angeben und einen privaten Link einrichten, können Sie die Metriken an eine Amazon-VPC-Endpunkt senden. Weitere Informationen finden Sie unter Was ist Amazon VPC?

    Der Wert von endpoint_override muss eine Zeichenkette sein, die eine URL ist.

    Beispielsweise legt der folgende Teil des Metrikabschnitts der Konfigurationsdatei fest, dass der Agent beim Senden von Metriken einen VPC-Endpunkt verwendet. 

    {
  "metrics": {
    "endpoint_override": "vpce-XXXXXXXXXXXXXXXXXXXXXXXXX.monitoring.us-east-1.vpce.amazonaws.com",
   ......
   },
}

  • metrics_collected – Erforderlich. Gibt an, welche Metriken erfasst werden sollen, einschließlich benutzerdefinierter Metriken, die mit StatsD oder collectd erfasst werden. Dieser Abschnitt enthält mehrere Unterabschnitte.

    Der Inhalt des metrics_collected-Abschnitts hängt davon ab, ob diese Konfigurationsdatei für einen Server mit Linux oder Windows Server vorgesehen ist.

  • metrics_destinations Optional. Gibt ein oder mehrere Ziele für alle in definierten Metriken anmetrics_collected. Falls hier angegeben, überschreibt es das Standardziel voncloudwatch.

    • cloudwatch— Amazon CloudWatch.

    • amp— Amazon Managed Service für Prometheus.

      • workspace_id— Die ID, die dem Amazon Managed Service for Prometheus Workspace entspricht.

    {
  "metrics": {
    "metrics_destinations": {
      "cloudwatch": {},
      "amp": {
        "workspace_id": "ws-abcd1234-ef56-7890-ab12-example"
      }
    }
  }
}

  • force_flush_interval – Gibt die maximale Zeitspanne in Sekunden an, in der Metriken im Speicherpuffer verbleiben, bevor sie an den Server gesendet werden. Unabhängig von dieser Einstellung werden die Metriken sofort an den Server gesendet, sobald die Größe der Metriken im Puffer 1 MB oder 1 000 verschiedene Metriken erreicht.

    Der Standardwert lautet 60.

  • credentials – Gibt eine IAM-Rolle an, die beim Senden von Metriken an ein anderes Konto verwendet werden soll. Sofern angegeben, enthält dieses Feld einen Parameter, role_arn.

    • role_arn – Gibt den ARN einer IAM-Rolle für die Authentifizierung beim Senden von Metriken an ein anderes Konto an. Weitere Informationen finden Sie unter Metriken, Protokolle und Ablaufverfolgungen an ein anderes Konto senden. Wenn dieser Wert hier angegeben wird, überschreibt er den role_arn im Abschnitt agent der Konfigurationsdatei, sofern vorhanden.

    • service.name Optional. Gibt den Servicenamen an, der verwendet werden soll, um die Entität für die Suche nach zugehöriger Telemetrie aufzufüllen.

    • deployment.environment Optional. Gibt den Umgebungsnamen an, der verwendet werden soll, um die Entität für die Suche nach verwandter Telemetrie aufzufüllen.

Linux-Abschnitt

Auf Servern mit Linux kann der Abschnitt metrics_collected der Konfigurationsdatei auch die folgenden Felder enthalten.

Viele dieser Felder können measurement-Bereiche enthalten, in denen die Metriken aufgelistet werden, die Sie für diese Ressource erfassen möchten. In diesen measurement-Abschnitten können Sie entweder den vollständigen Metriknamen, wie z. B. swap_used, oder nur den Teil des Metriknamens, der an die Typ der Ressource angehängt wird. Beispiel: Die Angabe von reads im Abschnitt measurement des Abschnitts diskio bewirkt, dass die Metrik diskio_reads erfasst wird.

  • collectd – Optional. Gibt an, dass Sie benutzerdefinierte Metriken mithilfe des Protokolls collectd abrufen möchten. Sie verwenden collectd Software, um die Metriken an den Agenten zu senden. CloudWatch Weitere Informationen zu den Konfigurationsoptionen, die für collectd verfügbar sind, finden Sie unter Abrufen benutzerdefinierter Metriken mit collectd.

  • cpu – Optional. Gibt an, dass CPU-Metriken erfasst werden sollen. Dieser Abschnitt gilt nur für Linux-Instances. Sie müssen mindestens eines der resources- und totalcpu-Felder für alle zu erfassenden CPU-Metriken einschließen. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Metriken an gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • resources Optional. Geben Sie dieses Feld mit dem Wert * an, um zu bewirken, dass pro CPU-Metriken erfasst werden. Der einzige zulässige Wert ist *.

    • totalcpu – Optional. Gibt an, ob CPU-Metriken gesammelt über alle CPU-Kerne hinweg gemeldet werden sollen. Der Standardwert ist „true“.

    • measurement – Gibt das Array der zu erfassenden CPU-Metriken an. Mögliche Werte sind time_active, time_guest, time_guest_nice, time_idle, time_iowait, time_irq, time_nice, time_softirq, time_steal, time_system, time_user, usage_active, usage_guest, usage_guest_nice, usage_idle, usage_iowait, usage_irq, usage_nice, usage_softirq, usage_steal, usage_system und usage_user. Dieses Feld muss angegeben werden, wenn Sie cpu einbeziehen.

      Standardmäßig ist die Einheit für cpu_usage_*-Metriken Percent; cpu_time_*-Metriken sind einheitenlos.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval – Optional. Gibt an, wie oft die CPU-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben. Beispiel: Angeben, dass 10 Metriken alle 10 Sekunden und 300 Metriken alle 5 Minuten gesammelt werden sollen.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen zu hochauflösenden Metriken finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Zusätzliche Dimensionen, die nur für die CPU-Metriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im globalen Feld append_dimensions angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agenten erfasst werden.

  • disk – Optional. Gibt an, dass Datenträger-Metriken erfasst werden sollen. Sammelt nur Messwerte für bereitgestellte Volumes. Dieser Abschnitt gilt nur für Linux-Instances. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Metriken gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • resources – Optional. Gibt ein Array von Datenträger-Mountingpunkten an. Dieses Feld beschränkt CloudWatch sich darauf, nur Metriken von den aufgelisteten Einhängepunkten zu sammeln. Sie können * als Wert festlegen, um Metriken von allen Mountingpunkten zu erfassen. Standardmäßig werden Metriken von allen Mountingpunkten erfasst.

    • measurement – Gibt das Array der zu erfassenden Disk-Metriken an. Mögliche Werte sind free, total, used, used_percent, inodes_free, inodes_used und inodes_total. Dieses Feld muss angegeben werden, wenn Sie disk einbeziehen.

      Anmerkung

      Die disk-Metriken haben eine Dimension für Partition, was bedeutet, dass die Anzahl der generierten benutzerdefinierten Metriken von der Anzahl der Partitionen abhängt, die Ihrer Instance zugeordnet sind. Die Anzahl der Festplattenpartitionen hängt davon ab, welches AMI Sie verwenden, und wie viele Amazon-EBS-Volumes Sie an den Server anfügen.

      Informationen zum Anzeigen der Standardeinheiten für jede disk-Metrik finden Sie unter Vom CloudWatch Agenten auf Linux- und macOS-Instances gesammelte Metriken.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None von None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • ignore_file_system_types – Gibt Dateisystemtypen an, die beim Erfassen von Datenträgermetriken ausgeschlossen werden sollen. Gültige Werte sind sysfs, devtmpfs usw.

    • drop_device – Wenn Sie dies auf true setzen, wird Device nicht als Dimension für Datenträgermetriken aufgenommen.

      Verhindern, dass Device als Dimension verwendet wird, kann auf Instances nützlich sein, die das Nitro-System verwenden, da sich die Gerätenamen auf diesen Instances bei jedem Datenträger-Mount ändern, wenn die Instance neu gestartet wird. Dies kann dazu führen, dass inkonsistente Daten in Ihren -Metriken und dazu führen, dass Alarme, die auf diesen Metriken basieren, in den Status INSUFFICIENT DATA übergehen.

      Der Standardwert ist false.

    • metrics_collection_interval – Optional. Gibt an, wie oft die Datenträger-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Geben Sie Schlüssel-Wert-Paare an, die als zusätzliche Dimensionen nur für die Festplattenmetriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im append_dimensions-Feld angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agent erfasst werden.

      Ein Schlüssel-Wert-Paar, das Sie verwenden können, ist das Folgende. Sie können auch andere benutzerdefinierte Schlüssel-Wert-Paare angeben.

      • "VolumeId":"${aws:VolumeId}"fügt den VolumeId Festplattenmetriken Ihres Blockgeräts eine Dimension hinzu. Für Amazon EBS-Volumes ist dies die Amazon EBS-Volume-ID. Zum EC2 Beispiel Store, dies wird die Seriennummer des Geräts sein. Um dies zu verwenden, muss der drop_device Parameter auf eingestellt seinfalse.

  • diskio – Optional. Gibt an, dass Diskio-Metriken erfasst werden sollen. Dieser Abschnitt gilt nur für Linux-Instances. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Metriken an gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • resources Optional. Wenn Sie eine Reihe von Geräten angeben, werden nur Messwerte von diesen Geräten CloudWatch erfasst. Andernfalls werden Metriken für alle Geräte erfasst. Sie können auch * als Wert festlegen, um Metriken von allen Geräten zu erfassen.

    • measurement – Gibt das Array der zu erfassenden Diskio-Metriken an. Mögliche Werte sind reads, writes, read_bytes, write_bytes, read_time, write_time, io_time und iops_in_progress. Dieses Feld muss angegeben werden, wenn Sie diskio einbeziehen.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None von None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval – Optional. Gibt an, wie oft die diskio-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen zu hochauflösenden Metriken finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Zusätzliche Dimensionen, die nur für die diskio-Metriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im append_dimensions-Feld angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agent erfasst werden.

  • swap – Optional. Gibt an, dass Swap-Arbeitsspeicher-Metriken erfasst werden sollen. Dieser Abschnitt gilt nur für Linux-Instances. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Messwerte gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • measurement – Gibt das Array der zu erfassenden Swap-Metriken an. Mögliche Werte sind free, used und used_percent. Dieses Feld muss angegeben werden, wenn Sie swap einbeziehen.

      Informationen zum Anzeigen der Standardeinheiten für jede swap-Metrik finden Sie unter Vom CloudWatch Agenten auf Linux- und macOS-Instances gesammelte Metriken.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None von None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval Optional. Gibt an, wie oft die Swap-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen zu hochauflösenden Metriken finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Zusätzliche Dimensionen, die nur für die Swap-Metriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im globalen append_dimensions-Feld angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agent erfasst werden. Der Wert wird als hochauflösende Metrik erfasst.

  • mem Optional. Gibt an, dass Arbeitsspeicher-Metriken erfasst werden sollen. Dieser Abschnitt gilt nur für Linux-Instances. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Messwerte gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • measurement – Gibt das Array der zu erfassenden Arbeitsspeicher-Metriken an. Mögliche Werte sind active, available, available_percent, buffered, cached, free, inactive, total, used und used_percent. Dieses Feld muss angegeben werden, wenn Sie mem einbeziehen.

      Informationen zum Anzeigen der Standardeinheiten für jede mem-Metrik finden Sie unter Vom CloudWatch Agenten auf Linux- und macOS-Instances gesammelte Metriken.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval Optional. Gibt an, wie oft die mem-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen zu hochauflösenden Metriken finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Zusätzliche Dimensionen, die nur für die mem-Metriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im Feld append_dimensions angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agenten erfasst werden.

  • net Optional. Gibt an, dass Netzwerk-Metriken erfasst werden sollen. Dieser Abschnitt gilt nur für Linux-Instances. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Messwerte gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • resources Optional. Wenn Sie ein Array von Netzwerkschnittstellen angeben, werden nur Metriken von diesen Schnittstellen CloudWatch erfasst. Andernfalls werden Metriken für alle Geräte erfasst. Sie können auch * als Wert festlegen, um Metriken von allen Schnittstellen zu erfassen.

    • measurement – Gibt das Array der zu erfassenden Netzwerk-Metriken an. Mögliche Werte sind bytes_sent, bytes_recv, drop_in, drop_out, err_in, err_out, packets_sent und packets_recv. Dieses Feld muss angegeben werden, wenn Sie net einbeziehen.

      Informationen zum Anzeigen der Standardeinheiten für jede net-Metrik finden Sie unter Vom CloudWatch Agenten auf Linux- und macOS-Instances gesammelte Metriken.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval Optional. Gibt an, wie oft die net-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben. Beispiel: Angeben, dass 10 Metriken alle 10 Sekunden und 300 Metriken alle 5 Minuten gesammelt werden sollen.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen zu hochauflösenden Metriken finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Zusätzliche Dimensionen, die nur für die net-Metriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im Feld append_dimensions angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agent erfasst werden.

  • netstat Optional. Gibt an, dass TCP-Verbindungsstatus und UDP-Verbindungsmetriken gesammelt werden sollen. Dieser Abschnitt gilt nur für Linux-Instances. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Messwerte gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • measurement – Gibt das Array der zu erfassenden Netstat-Metriken an. Mögliche Werte sind tcp_close, tcp_close_wait, tcp_closing, tcp_established, tcp_fin_wait1, tcp_fin_wait2, tcp_last_ack, tcp_listen, tcp_none, tcp_syn_sent, tcp_syn_recv, tcp_time_wait und udp_socket. Dieses Feld muss angegeben werden, wenn Sie netstat einbeziehen.

      Informationen zum Anzeigen der Standardeinheiten für jede netstat-Metrik finden Sie unter Vom CloudWatch Agenten auf Linux- und macOS-Instances gesammelte Metriken.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval Optional. Gibt an, wie oft die netstat-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen zu hochauflösenden Metriken finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Zusätzliche Dimensionen, die nur für die netstat-Metriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im Feld append_dimensions angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agent erfasst werden.

  • processes Optional. Gibt an, dass Prozess-Metriken erfasst werden sollen. Dieser Abschnitt gilt nur für Linux-Instances. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Messwerte gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • measurement – Gibt das Array der zu erfassenden Prozess-Metriken an. Mögliche Werte sind blocked, dead, idle, paging, running, sleeping, stopped, total, total_threads, wait und zombies. Dieses Feld muss angegeben werden, wenn Sie processes einbeziehen.

      Für alle processes-Metriken lautet die Standardeinheit None.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval Optional. Gibt an, wie oft die Prozess-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

      Der Wert wird in Sekunden angegeben. Beispiel: Angeben, dass 10 Metriken alle 10 Sekunden und 300 Metriken alle 5 Minuten gesammelt werden sollen.

      Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen finden Sie unter Hochauflösende Metriken.

    • append_dimensions – Optional. Zusätzliche Dimensionen, die nur für die Prozess-Metriken verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im Feld append_dimensions angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agent erfasst werden.

  • nvidia_gpu Optional. Gibt an, dass NVIDIA GPU-Metriken erfasst werden sollen. Dieser Abschnitt gilt nur für Linux-Instances auf Hosts, die mit einem NVIDIA GPU-Accelerator konfiguriert sind und auf denen das NVIDIA System Management Interface (nvidia-smi) installiert ist.

    Den erfassten NVIDIA GPU-Metriken wird die Zeichenfolge nvidia_smi_ vorangestellt, um sie von den Metriken zu unterscheiden, die für andere Accelerator-Typen erfasst wurden. Dieser Abschnitt kann die folgenden Felder enthalten:

    • drop_original_metrics – Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Messwerte gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

    • measurement – Gibt das Array der zu erfassenden NVIDIA GPU-Metriken an. Eine Liste der möglichen Werte, die Sie hier verwenden können, finden Sie in der Spalte Metric (Metrik) in der Tabelle unter Erfassen von NVIDIA GPU-Metriken.

      Im Eintrag für jede einzelne Metrik können Sie optional einen oder beide der folgenden Werte angeben:

      • rename – Legt einen anderen Namen für diese Metrik fest.

      • unit – Gibt die zu verwendende Einheit für diese Metrik an und überschreibt die Standardeinheit für die Metrik (None). Bei der von Ihnen angegebenen Einheit muss es sich um eine gültige CloudWatch metrische Einheit handeln, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

    • metrics_collection_interval Optional. Gibt an, wie oft die NVIDIA GPU-Metriken erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

  • jmx Optional. Gibt an, dass Sie JMX-Metriken (Java Management Extensions) von der Instanz abrufen möchten. Weitere Informationen zu den Parametern, die Sie in diesem Abschnitt verwenden können, und zu den Metriken, die Sie sammeln können, finden Sie unterErfassen Sie Metriken zu Java Management Extensions (JMX).

  • otlp Optional. Gibt an, dass Sie Metriken aus dem OpenTelemetry SDK sammeln möchten. Weitere Informationen zu den Feldern, die Sie in diesem Abschnitt verwenden können, finden Sie unterSammeln Sie Metriken und Traces mit OpenTelemetry.

  • procstat Optional. Gibt an, dass Sie Metriken aus einzelnen Prozessen abrufen möchten. Weitere Informationen zu den Konfigurationsoptionen, die für procstat verfügbar sind, finden Sie unter Erfassen von Prozessmetriken mit dem procstat-Plugin.

  • statsd – Optional. Gibt an, dass Sie benutzerdefinierte Metriken mithilfe des Protokolls StatsD abrufen möchten. Der CloudWatch Agent fungiert als Daemon für das Protokoll. Sie verwenden einen beliebigen StatsD Standard-Client, um die Metriken an den CloudWatch Agenten zu senden. Weitere Informationen zu den Konfigurationsoptionen, die für StatsD verfügbar sind, finden Sie unter Abrufen benutzerdefinierter Metriken mit StatsD.

  • ethtool – Optional. Gibt an, dass Sie Netzwerkmetriken mithilfe des ethtool-Plug-Ins abrufen möchten. Dieses Plugin kann sowohl die vom Standard-Ethtool-Hilfsprogramm gesammelten Metriken als auch die Netzwerkleistungsmetriken von EC2 Amazon-Instances importieren. Weitere Informationen zu den Konfigurationsoptionen, die für ethtool verfügbar sind, finden Sie unter Netzwerkleistungsmetriken sammeln.

Es folgt das Beispiel eines metrics-Abschnitts für einen Linux-Server. In diesem Beispiel werden drei CPU-Metriken, drei netstat-Metriken, drei Prozessmetriken und eine Datenträgermetrik erfasst und der Agent ist zum Empfang zusätzlicher Metriken von einem collectd-Client eingerichtet.

"metrics": {
    "aggregation_dimensions" : [["AutoScalingGroupName"], ["InstanceId", "InstanceType"],[]],
    "metrics_collected": {
      "collectd": {},
      "cpu": {
        "resources": [
          "*"
        ],
        "measurement": [
          {"name": "cpu_usage_idle", "rename": "CPU_USAGE_IDLE", "unit": "Percent"},
          {"name": "cpu_usage_nice", "unit": "Percent"},
          "cpu_usage_guest"
        ],
        "totalcpu": false,
        "drop_original_metrics": [ "cpu_usage_guest" ],
        "metrics_collection_interval": 10,
        "append_dimensions": {
          "test": "test1",
          "date": "2017-10-01"
        }
      },
      "netstat": {
        "measurement": [
          "tcp_established",
          "tcp_syn_sent",
          "tcp_close"
        ],
        "metrics_collection_interval": 60
      },
       "disk": {
        "measurement": [
          "used_percent"
        ],
        "resources": [
          "*"
        ],
        "drop_device": true
      },  
      "processes": {
        "measurement": [
          "running",
          "sleeping",
          "dead"
        ]
      }
    },
    "append_dimensions": {
      "ImageId": "${aws:ImageId}",
      "InstanceId": "${aws:InstanceId}",
      "InstanceType": "${aws:InstanceType}",
      "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
    }
  }

Windows Server

Im Abschnitt metrics_collected für Windows Server können Sie für jedes Windows-Leistungsobjekt Unterabschnitte anlegen, beispielsweise Memory, Processor und LogicalDisk. Informationen darüber, welche Objekte und Zähler verfügbar sind, finden Sie unter Leistungszähler in der Microsoft Windows-Dokumentation.

Innerhalb des Unterabschnitts für jedes Objekt geben Sie ein measurement-Array der zu erfassenden Zähler an. Das measurement-Array ist für jedes Objekt erforderlich, das Sie in der Konfigurationsdatei angeben. Sie können auch ein resources-Feld angeben, um die Instances zu benennen, aus denen Sie Metriken erfassen. Sie können auch * für resources angeben, um separate Metriken für alle Instances zu erfassen. Wenn Sie resources bei Zählern mit Instances weglassen, werden die Daten für alle Instances in einem Satz zusammengefasst. Wenn Sie resources bei Zählern, die keine Instances haben, weglassen, werden die Zähler nicht vom Agenten erfasst. CloudWatch Um festzustellen, ob Zähler über Instances verfügen, können Sie einen der folgenden Befehle verwenden.

Powershell:

Get-Counter -ListSet *

Befehlszeile (nicht Powershell):

TypePerf.exe –q

Innerhalb des jeweiligen Objektabschnitts können Sie auch die folgenden optionalen Felder angeben:

  • metrics_collection_interval Optional. Gibt an, wie oft die Metriken für dieses Objekt erfasst werden und das globale metrics_collection_interval im Abschnitt agent der Konfigurationsdatei überschrieben wird.

    Der Wert wird in Sekunden angegeben. Beispiel: Angeben, dass 10 Metriken alle 10 Sekunden und 300 Metriken alle 5 Minuten gesammelt werden sollen.

    Wenn Sie diesen Wert auf weniger als 60 Sekunden festlegen, wird die jeweilige Metrik als hochauflösende Metrik erfasst. Weitere Informationen finden Sie unter Hochauflösende Metriken.

  • append_dimensions – Optional. Gibt zusätzliche Dimensionen an, die nur für die Metriken für dieses Objekt verwendet werden sollen. Falls Sie dieses Feld angeben, wird es zusätzlich zu den im globalen Feld append_dimensions angegebenen Dimensionen verwendet, das für alle Typen von Metriken verwendet wird, die vom Agent erfasst werden.

  • drop_original_metrics Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Metriken an gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine Kennzahlen nach Dimension gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

Innerhalb des jeweiligen Zählerabschnitts können Sie auch die folgenden optionalen Felder angeben:

  • rename— Gibt einen anderen Namen an, der CloudWatch für diese Metrik verwendet werden soll.

  • unit – Gibt die für diese Metrik zu verwendende Einheit an. Die von Ihnen angegebene Einheit muss eine gültige CloudWatch metrische Einheit sein, wie in der Unit Beschreibung unter aufgeführt MetricDatum.

Es gibt weitere optionale Abschnitte, die Sie in folgende Bereiche aufnehmen könnenmetrics_collected:

  • statsd – Ermöglicht den Abruf benutzerdefinierter Metriken mittels StatsD-Protokoll. Der CloudWatch Agent fungiert als Daemon für das Protokoll. Sie können die Metriken mit einem beliebigen StatsD-Standardclient an den CloudWatch-Agenten senden. Weitere Informationen finden Sie unter Abrufen benutzerdefinierter Metriken mit StatsD.

  • procstat – Ermöglicht den Abruf von Metriken aus einzelnen Prozessen. Weitere Informationen finden Sie unter Erfassen von Prozessmetriken mit dem procstat-Plugin.

  • jmx – Optional. Gibt an, dass Sie JMX-Metriken (Java Management Extensions) von der Instanz abrufen möchten. Weitere Informationen zu den Feldern, die Sie in diesem Abschnitt verwenden können, und zu den Metriken, die Sie sammeln können, finden Sie unterErfassen Sie Metriken zu Java Management Extensions (JMX).

  • otlp Optional. Gibt an, dass Sie Metriken aus dem OpenTelemetry SDK sammeln möchten. Weitere Informationen zu den Feldern, die Sie in diesem Abschnitt verwenden können, finden Sie unterSammeln Sie Metriken und Traces mit OpenTelemetry.

Es folgt das Beispiel eines metrics-Abschnitts zur Verwendung unter Windows Server. In diesem Beispiel werden viele Windows-Metriken erfasst, und der Computer ist zusätzlich für das Empfangen weiterer Metriken von einem StatsD-Client eingerichtet.

"metrics": {
    "metrics_collected": {
      "statsd": {},
      "Processor": {
        "measurement": [
          {"name": "% Idle Time", "rename": "CPU_IDLE", "unit": "Percent"},
          "% Interrupt Time",
          "% User Time",
          "% Processor Time"
        ],
        "resources": [
          "*"
        ],
        "append_dimensions": {
          "d1": "win_foo",
          "d2": "win_bar"
        }
      },
      "LogicalDisk": {
        "measurement": [
          {"name": "% Idle Time", "unit": "Percent"},
          {"name": "% Disk Read Time", "rename": "DISK_READ"},
          "% Disk Write Time"
        ],
        "resources": [
          "*"
        ]
      },
      "Memory": {
        "metrics_collection_interval": 5,
        "measurement": [
          "Available Bytes",
          "Cache Faults/sec",
          "Page Faults/sec",
          "Pages/sec"
        ],
        "append_dimensions": {
          "d3": "win_bo"
        }
      },
      "Network Interface": {
        "metrics_collection_interval": 5,
        "measurement": [
          "Bytes Received/sec",
          "Bytes Sent/sec",
          "Packets Received/sec",
          "Packets Sent/sec"
        ],
        "resources": [
          "*"
        ],
        "append_dimensions": {
          "d3": "win_bo"
        }
      },
      "System": {
        "measurement": [
          "Context Switches/sec",
          "System Calls/sec",
          "Processor Queue Length"
        ],
        "append_dimensions": {
          "d1": "win_foo",
          "d2": "win_bar"
        }
      }
    },
    "append_dimensions": {
      "ImageId": "${aws:ImageId}",
      "InstanceId": "${aws:InstanceId}",
      "InstanceType": "${aws:InstanceType}",
      "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
    },
    "aggregation_dimensions" : [["ImageId"], ["InstanceId", "InstanceType"], ["d1"],[]]
    }
  }

Der Abschnitt logs enthält die folgenden Felder:

  • service.name Optional. Gibt den Dienstnamen an, der verwendet werden soll, um die Entität für die Suche nach verwandter Telemetrie aufzufüllen.

  • deployment.environment Optional. Gibt den Umgebungsnamen an, der verwendet werden soll, um die Entität für die Suche nach verwandter Telemetrie aufzufüllen.

  • logs_collected – Erforderlich, sofern der Abschnitt logs enthalten ist. Gibt an, welche Protokolldateien und Windows-Ereignisprotokolle vom Server erfasst werden sollen. Kann zwei Felder enthalten: files und windows_events.

    • files— Gibt an, welche regulären Protokolldateien der CloudWatch Agent sammeln soll. Enthält das Feld collect_list, das diese Dateien genauer definiert.

      • collect_list – Erforderlich, wenn files enthalten ist. Enthält ein Array von Einträgen, die jeweils eine zu erfassende Protokolldatei angeben. Jeder dieser Einträge kann die folgenden Felder enthalten:

        • file_path— Gibt den Pfad der Protokolldatei an, die in CloudWatch Logs hochgeladen werden soll. Globale standardmäßige Unixabgleichsregeln werden akzeptiert. ** muss als super asterisk hinzugefügt werden. Beispiel: Angeben von /var/log/**.log bewirkt, dass alle .log-Dateien in der /var/log-Verzeichnisstruktur erfasst werden. Weitere Beispiele finden Sie in der globalen Bibliothek.

          Sie können das Standardsternchen auch als Standardplatzhalter verwenden. Beispiel: /var/log/system.log* findet Dateien wie system.log_1111, system.log_2222 usw. in /var/log.

          Nur die neueste Datei wird basierend auf der Änderungszeit der Datei in die CloudWatch Logs übertragen. Wir empfehlen, dass Sie eine Reihe von Platzhaltern angeben, z. B. Dateien desselben Typs, access_log.2018-06-01-01 und access_log.2018-06-01-02, aber nicht mehrere Arten von Dateien, wie z. B. access_log_80 und access_log_443. Wenn Sie mehrere Arten von Dateien angeben möchten, fügen Sie der Agentenkonfigurationsdatei einen anderen Protokoll-Stream-Eintrag hinzu, damit jede Art von Protokolldatei in einen anderen Protokoll-Stream gestellt wird.

        • auto_removal Optional. Wenn dies der Fall isttrue, löscht der CloudWatch Agent diese Protokolldatei nach dem Lesen automatisch und sie wurde rotiert. Normalerweise werden die Protokolldateien gelöscht, nachdem ihr gesamter Inhalt in CloudWatch Logs hochgeladen wurde. Wenn der Agent jedoch das EOF (Dateiende) erreicht und auch eine andere neuere Protokolldatei entdeckt, die dieser entsprichtfile_path, löscht der Agent die ALTE Datei. Sie müssen also sicherstellen, dass Sie mit dem Schreiben in die ALTE Datei fertig sind, bevor Sie die NEUE Datei erstellen. Die RUST-Tracing-Bibliothek weist eine bekannte Inkompatibilität auf, da sie möglicherweise eine NEUE Protokolldatei erstellt und dann trotzdem versucht, in die ALTE Protokolldatei zu schreiben.

          Der Agent entfernt aus Protokollen, die mehrere Dateien erstellen, nur vollständige Dateien. Dies sind z. B. Protokolle, die für jedes Datum separate Dateien erstellen. Wenn ein Protokoll kontinuierlich in eine einzige Datei schreibt, wird es nicht entfernt.

          Wenn Sie bereits eine Rotations- oder Entfernungsmethode für Protokolldateien eingerichtet haben, sollten Sie dieses Feld auslassen oder auf false festlegen.

          Wenn Sie dieses Feld auslassen, wird der Standardwert false verwendet.

        • log_group_name Optional. Gibt an, was als Protokollgruppenname in CloudWatch Logs verwendet werden soll.

          Wir empfehlen, in diesem Feld einen Protokollgruppen-Namen festzulegen, um Verwirrungen zu vermeiden. Wenn Sie log_group_name auslassen, wird der Wert von file_path bis zu dem letzten Punkt als Name der Protokollgruppe verwendet. Beispiel: Falls der Dateipfad /tmp/TestLogFile.log.2017-07-11-14 ist, lautet der Name der Protokollgruppe /tmp/TestLogFile.log.

          Wenn Sie einen Protokollgruppennamen angeben, können Sie{instance_id}, {hostname}{local_hostname}, und {ip_address} als Variablen innerhalb des Namens verwenden. {hostname}ruft den Hostnamen aus den EC2 Metadaten ab und {local_hostname} verwendet den Hostnamen aus der Netzwerkkonfigurationsdatei.

          Wenn Sie diese Variablen verwenden, um viele verschiedene Loggruppen zu erstellen, beachten Sie die Begrenzung auf 1.000.000 Loggruppen pro Region und Konto.

          Zulässige Zeichen sind a – z, A – Z, 0 – 9, „_“ (Unterstrich), „-“ (Bindestrich), „/“ (Schrägstrich) und „.“ (Punkt).

        • log_group_class Optional. Gibt an, welche Protokollgruppen-Klasse für die neue Protokollgruppe verwendet werden soll. Weitere Hinweise zu Protokollgruppen-Klassen finden Sie unter Protokollklassen.

          Gültige Werte sind STANDARD und INFREQUENT_ACCESS. Wenn Sie dieses Feld auslassen, wird der Standard STANDARD verwendet.

          Wichtig

          Nachdem eine Protokollgruppe erstellt wurde, kann ihre Klasse nicht mehr geändert werden.

        • log_stream_name Optional. Gibt an, was als Log-Stream-Name in Logs verwendet werden soll. CloudWatch Als Teil des Namens können Sie, {instance_id} {hostname}{local_hostname}, und {ip_address} als Variablen innerhalb des Namens verwenden. {hostname}ruft den Hostnamen aus den EC2 Metadaten ab und {local_hostname} verwendet den Hostnamen aus der Netzwerkkonfigurationsdatei.

          Wenn Sie dieses Feld auslassen, wird der Wert des Parameters log_stream_name im globalen logs-Abschnitt verwendet. Wird dies ebenfalls weggelassen, wird der Standardwert von {instance_id} verwendet.

          Wenn ein Protokoll-Stream noch nicht vorhanden ist, wird er automatisch erstellt.

        • retention_in_days Optional. Gibt an, wie viele Tage lang die Protokollereignisse in der festgelegten Protokollgruppe aufbewahrt werden.

          • Wenn der Agent diese Protokollgruppe jetzt erstellt und Sie dieses Feld auslassen, wird die Aufbewahrung dieser neuen Protokollgruppe auf niemals ablaufend gesetzt.

          • Wenn diese Protokollgruppe bereits vorhanden ist und Sie dieses Feld angeben, wird die von Ihnen angegebene neue Aufbewahrung verwendet. Wenn Sie dieses Feld für eine bereits vorhandene Protokollgruppe weglassen, wird die Aufbewahrung der Protokollgruppe nicht geändert.

            Der CloudWatch Agent-Assistent verwendet -1 als Standardwert für dieses Feld, wenn es zur Erstellung der Agent-Konfigurationsdatei verwendet wird und Sie keinen Wert für die Protokollaufbewahrung angeben. Dieser vom Assistenten festgelegte -1 Wert gibt an, dass die Ereignisse in der Protokollgruppe niemals ablaufen. Das manuelle Ändern dieses Werts auf -1 hat jedoch keine Auswirkung.

          Mögliche Werte sind 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, 2192, 2557, 2922, 3288 und 3653.

          Wenn Sie den Agenten so konfigurieren, dass er mehrere Protokollstreams in dieselbe Protokollgruppe schreibt, und Sie retention_in_days an einer Stelle angeben, wird damit die Protokollaufbewahrung für die gesamte Protokollgruppe festgelegt. Wenn Sie retention_in_days an mehreren Stellen für dieselbe Protokollgruppe angeben und alle diese Werte gleich sind, wird die Aufbewahrung festgelegt. Werden jedoch für dieselbe Protokollgruppe an mehreren Stellen unterschiedliche retention_in_days-Werte angegeben, wird die Protokollaufbewahrung nicht festgelegt und der Agent wird gestoppt und gibt einen Fehler zurück.

          Anmerkung

          Die IAM-Rolle oder der IAM-Benutzer des Agenten muss über logs:PutRetentionPolicy verfügen, damit sie bzw. er Aufbewahrungsrichtlinien festlegen kann. Weitere Informationen finden Sie unter Erlauben Sie dem CloudWatch Agenten, eine Richtlinie zur Aufbewahrung von Protokollen festzulegen.

          Warnung

          Wenn Sie für eine bereits vorhandene Protokollgruppe retention_in_days festlegen, werden alle Protokolle in dieser Protokollgruppe, die vor der von Ihnen angegebenen Anzahl von Tagen veröffentlicht wurden, gelöscht. Wenn Sie beispielsweise den Wert 3 festlegen, werden alle Protokolle gelöscht, die 3 oder mehr Tage alt sind.

        • filters Optional. Kann ein Array von Einträgen enthalten, von denen jeder einen regulären Ausdruck und einen Filtertyp angibt, um anzugeben, ob Protokolleinträge, die dem Filter entsprechen, veröffentlicht oder gelöscht werden sollen. Wenn Sie dieses Feld weglassen, werden alle Protokolle in der Protokolldatei in CloudWatch Logs veröffentlicht. Wenn Sie dieses Feld angeben, verarbeitet der Agent jede Protokollnachricht mit allen von Ihnen angegebenen Filtern, und nur die Protokollereignisse, die alle Filter bestehen, werden in CloudWatch Logs veröffentlicht. Die Protokolleinträge, die nicht alle Filter bestehen, verbleiben weiterhin in der Protokolldatei des Hosts, werden aber nicht an CloudWatch Logs gesendet.

          Jeder Eintrag im Filter-Array kann die folgenden Felder enthalten:

          • type – Gibt den Filtertyp an. Gültige Werte sind include und exclude. Bei include muss der Protokolleintrag mit dem Ausdruck übereinstimmen, der in CloudWatch Logs veröffentlicht werden soll. Bei exclude wird nicht jeder Protokolleintrag, der dem Filter entspricht, an CloudWatch Logs gesendet.

          • expression— Eine Zeichenfolge für reguläre Ausdrücke, die der RE2 Syntax folgt.

            Anmerkung

            Der CloudWatch Agent überprüft nicht die Leistung eines von Ihnen angegebenen regulären Ausdrucks und schränkt auch nicht die Laufzeit der Auswertung der regulären Ausdrücke ein. Wir empfehlen, darauf zu achten, keinen Ausdruck zu erstellen, dessen Auswertung hohe Kosten verursacht. Weitere Informationen zu möglichen Problemen finden Sie unter Denial of Service für reguläre Ausdrücke — ReDo S

          Der folgende Auszug aus der CloudWatch Agentenkonfigurationsdatei veröffentlicht beispielsweise Protokolle, bei denen es sich um PUT- und POST-Anfragen handelt, in CloudWatch Logs, jedoch keine Protokolle, die von Firefox stammen.

          "collect_list": [ 
  {
    "file_path": "/opt/aws/amazon-cloudwatch-agent/logs/test.log", 
    "log_group_name": "test.log", 
    "log_stream_name": "test.log",
    "filters": [
      {
        "type": "exclude",
        "expression": "Firefox"
      },
      {
        "type": "include",
        "expression": "P(UT|OST)"
      }
    ]
  },
  .....
]
          Anmerkung

          Die Reihenfolge der Filter in der Konfigurationsdatei ist für die Leistung wichtig. Im vorherigen Beispiel löscht der Agent alle Protokolle, die mit Firefox übereinstimmen, bevor er mit der Auswertung des zweiten Filters beginnt. Wenn weniger Protokolleinträge mit mehreren Filtern ausgewertet werden sollen, platzieren Sie den Filter, der voraussichtlich mehr Protokolle ausschließt, an der ersten Stelle in der Konfigurationsdatei.

        • timezone Optional. Gibt die Zeitzone an, die verwendet werden soll, wenn Zeitstempel auf Protokollereignisse angewendet werden. Die gültigen Werte sind UTC und Local. Der Standardwert ist Local.

          Dieser Parameter wird ignoriert, wenn Sie keinen Wert für timestamp_format angeben.

        • timestamp_format Optional. Gibt das Zeitstempelformat an, wobei Klartext und spezielle Symbole verwendet werden, die mit % beginnen. Wenn Sie dieses Feld nicht ausfüllen, wird die aktuelle Zeit verwendet. Wenn Sie dieses Feld verwenden, können Sie die Symbole aus der folgenden Liste als Teil des Formats verwenden.

          Anmerkung

          Dieser Parameter wird nicht berücksichtigt, wenn der auf gesetzt file_path ist amazon-cloudwatch-agent.log

          Wenn ein einzelner Protokolleintrag zwei Zeitstempel enthält, die dem Format entsprechen, wird der erste Zeitstempel verwendet.

          Diese Liste von Symbolen unterscheidet sich von der Liste, die vom älteren CloudWatch Logs-Agenten verwendet wurde. Eine Zusammenfassung der Unterschiede finden Sie unter Zeitstempelunterschiede zwischen dem Unified CloudWatch Agent und dem früheren CloudWatch Logs-Agenten.

          %y

          Jahr ohne Jahrhundert als mit Nullen aufgefüllte Dezimalzahl Zum Beispiel, 19 um 2019 darzustellen.

          %Y

          Jahr mit Jahrhundert als Dezimalzahl Beispiel, 2019.

          %b

          Monat als Abkürzung des Namens des Gebietsschemas

          %B

          Monat als vollständiger Name des Gebietsschemas

          %m

          Monat als mit Nullen aufgefüllte Dezimalzahl

          %-m

          Monat als Dezimalzahl (nicht mit Nullen aufgefüllt)

          %d

          Tag des Monats als mit Nullen aufgefüllte Dezimalzahl

          %-d

          Tag des Monats als Dezimalzahl (nicht mit Nullen aufgefüllt)

          %A

          Vollständiger Name des Wochentags, wie z. B. Monday

          %a

          Abkürzung des Wochentags, wie z. B. Mon

          %H

          Stunde (24-Stunden-Format) als mit Nullen aufgefüllte Dezimalzahl

          %I

          Stunde (12-Stunden-Format) als mit Nullen aufgefüllte Dezimalzahl

          %-I

          Stunde (12-Stunden-Format) als Dezimalzahl (nicht mit Nullen aufgefüllt)

          %p

          AM oder PM

          %M

          Minuten als mit Nullen aufgefüllte Dezimalzahl

          %-M

          Minuten als Dezimalzahl (nicht mit Nullen aufgefüllt)

          %S

          Sekunden als mit Nullen aufgefüllte Dezimalzahl

          %-S

          Sekunden als Dezimalzahl (nicht mit Nullen aufgefüllt)

          %f

          Sekundenbruchteile als Dezimalzahl (1 bis 9 Ziffern), links mit Nullen aufgefüllt.

          %Z

          Zeitzone, z. B. PST

          %z

          Zeitzone, ausgedrückt als der Abstand zwischen der lokalen Zeitzone und der Koordinierten Weltzeit (UTC). Beispiel, -0700. Es wird nur das dieses Format unterstützt. Beispiel: -07:00 ist kein gültiges Format.

        • multi_line_start_pattern – Gibt das Muster an, anhand dessen der Beginn einer Protokollmeldung identifiziert wird. Eine Protokollmeldung besteht aus einer Zeile, die mit dem angegebenen Muster übereinstimmt, und allen folgenden Zeilen, die nicht dem Muster entsprechen.

          Wenn Sie dieses Feld leer lassen, wird der Mehrzeilenmodus deaktiviert und bei jeder Zeile, die mit einem Zeichen beginnt, das kein Leerzeichen ist, wird der vorherige Protokolleintrag abgeschlossen und ein neuer Protokolleintrag gestartet.

          Wenn Sie dieses Feld aufnehmen, können Sie {timestamp_format} angeben, um den gleichen regulären Ausdruck wie Ihr Zeitstempelformat zu verwenden. Andernfalls können Sie für CloudWatch Logs einen anderen regulären Ausdruck angeben, anhand dessen die Startzeilen von mehrzeiligen Einträgen bestimmt werden.

        • encoding – Gibt die Codierung der Protokolldatei an, damit sie korrekt gelesen werden kann. Wenn Sie eine falsche Codierung angeben, kann dies zu Datenverlust führen, weil Zeichen, die nicht decodiert werden können, durch andere Zeichen ersetzt werden.

          Der Standardwert ist utf-8. Die folgenden Werte sind möglich:

          ascii, big5, euc-jp, euc-kr, gbk, gb18030, ibm866, iso2022-jp, iso8859-2, iso8859-3, iso8859-4, iso8859-5, iso8859-6, iso8859-7, iso8859-8, iso8859-8-i, iso8859-10, iso8859-13, iso8859-14, iso8859-15, iso8859-16, koi8-r, koi8-u, macintosh, shift_jis, utf-8, utf-16, utf-16le, UTF-16, UTF-16LE, windows-874, windows-1250, windows-1251, windows-1252, windows-1253, windows-1254, windows-1255, windows-1256, windows-1257, windows-1258, x-mac-cyrillic

        • service.name Optional. Gibt den Dienstnamen an, der verwendet werden soll, um die Entität für die Suche nach verwandter Telemetrie aufzufüllen.

        • deployment.environment Optional. Gibt den Umgebungsnamen an, der verwendet werden soll, um die Entität für die Suche nach verwandter Telemetrie aufzufüllen.

    • Im Abschnitt windows_events ist der Typ der Windows-Ereignisse angegeben, der von Servern mit Windows Server erfasst wird. Er enthält folgende Felder:

      • collect_list – Erforderlich, wenn windows_events enthalten ist. Gibt die Typen und Stufen von zu erfassenden Windows-Ereignissen an. Jedes zu erfassende Protokoll hat einen Eintrag in diesem Abschnitt, der folgende Felder enthalten kann:

        • event_name – Gibt den Typ der zu protokollierenden Windows-Ereignisse an. Dies entspricht dem Kanalnamen des Windows-Ereignisprotokolls, z. B. System, Security, Application usw. Dieses Feld ist für jeden Typ eines zu protokollierenden Windows-Ereignisses ein Pflichtfeld.

          Anmerkung

          Beim CloudWatch Abrufen von Nachrichten aus einem Windows-Protokollkanal wird der Protokollkanal anhand seiner Eigenschaft gesucht. Full Name Währenddessen zeigt der Navigationsbereich der Windows Event Viewer die Log Name-Eigenschaft von Protokollkanälen an. Full Name und Log Name stimmen nicht immer überein. Um den Full Name eines Kanals zu bestätigen, klicken Sie in der Windows Event Viewer mit der rechten Maustaste darauf und öffnen Sie Eigenschaften.

        • event_levels – Gibt die Ebenen des zu protokollierenden Ereignisses an. Sie müssen jede zu protokollierende Ebene angeben. Mögliche Werte sind INFORMATION, WARNING, ERROR, CRITICAL und VERBOSE. Dieses Feld ist für jeden Typ eines zu protokollierenden Windows-Ereignisses ein Pflichtfeld.

        • log_group_name – Erforderlich. Gibt an, was als Protokollgruppenname in CloudWatch Logs verwendet werden soll.

        • log_stream_name Optional. Gibt an, was als Name des Protokolldatenstroms in CloudWatch Logs verwendet werden soll. Als Teil des Namens können Sie, {instance_id} {hostname}{local_hostname}, und {ip_address} als Variablen innerhalb des Namens verwenden. {hostname}ruft den Hostnamen aus den EC2 Metadaten ab und {local_hostname} verwendet den Hostnamen aus der Netzwerkkonfigurationsdatei.

          Wenn Sie dieses Feld auslassen, wird der Wert des Parameters log_stream_name im globalen logs-Abschnitt verwendet. Wird dies ebenfalls weggelassen, wird der Standardwert von {instance_id} verwendet.

          Wenn ein Protokoll-Stream noch nicht vorhanden ist, wird er automatisch erstellt.

        • event_format Optional. Gibt das Format an, das beim Speichern von Windows-Ereignissen in Protokollen verwendet werden soll. CloudWatch xmlverwendet das XML-Format wie in der Windows-Ereignisanzeige. textverwendet das CloudWatch Legacy-Logs-Agent-Format.

        • retention_in_days Optional. Gibt an, wie viele Tage lang die Windows-Ereignisse in der festgelegten Protokollgruppe aufbewahrt werden.

          • Wenn der Agent diese Protokollgruppe jetzt erstellt und Sie dieses Feld auslassen, wird die Aufbewahrung dieser neuen Protokollgruppe auf niemals ablaufend gesetzt.

          • Wenn diese Protokollgruppe bereits vorhanden ist und Sie dieses Feld angeben, wird die von Ihnen angegebene neue Aufbewahrung verwendet. Wenn Sie dieses Feld für eine bereits vorhandene Protokollgruppe weglassen, wird die Aufbewahrung der Protokollgruppe nicht geändert.

            Der CloudWatch Agent-Assistent verwendet -1 als Standardwert für dieses Feld, wenn es zur Erstellung der Agent-Konfigurationsdatei verwendet wird und Sie keinen Wert für die Aufbewahrung von Protokollen angeben. Dieser vom Assistenten festgelegte -1-Wert legt fest, dass die Ereignisse in der Protokollgruppe nicht ablaufen. Das manuelle Ändern dieses Werts auf -1 hat jedoch keine Auswirkung.

          Mögliche Werte sind 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, 2192, 2557, 2922, 3288 und 3653.

          Wenn Sie den Agenten so konfigurieren, dass er mehrere Protokollstreams in dieselbe Protokollgruppe schreibt, und Sie retention_in_days an einer Stelle angeben, wird damit die Protokollaufbewahrung für die gesamte Protokollgruppe festgelegt. Wenn Sie retention_in_days an mehreren Stellen für dieselbe Protokollgruppe angeben und alle diese Werte gleich sind, wird die Aufbewahrung festgelegt. Werden jedoch für dieselbe Protokollgruppe an mehreren Stellen unterschiedliche retention_in_days-Werte angegeben, wird die Protokollaufbewahrung nicht festgelegt und der Agent wird gestoppt und gibt einen Fehler zurück.

          Anmerkung

          Die IAM-Rolle oder der IAM-Benutzer des Agenten muss über logs:PutRetentionPolicy verfügen, damit sie bzw. er Aufbewahrungsrichtlinien festlegen kann. Weitere Informationen finden Sie unter Erlauben Sie dem CloudWatch Agenten, eine Richtlinie zur Aufbewahrung von Protokollen festzulegen.

          Warnung

          Wenn Sie für eine bereits vorhandene Protokollgruppe retention_in_days festlegen, werden alle Protokolle in dieser Protokollgruppe, die vor der von Ihnen angegebenen Anzahl von Tagen veröffentlicht wurden, gelöscht. Wenn Sie beispielsweise den Wert 3 festlegen, werden alle Protokolle gelöscht, die 3 oder mehr Tage alt sind.

  • log_stream_name Optional. Gibt den Namen des standardmäßigen Protokoll-Streams an, der für alle Protokolle oder Windows-Ereignisse verwendet werden soll, für die kein Name eines Protokoll-Streams im Parameter log_stream_name des zugehörigen Eintrags in collect_list definiert ist.

  • endpoint_override – Gibt einen FIPS-Endpunkt oder einen privaten Link an, der als Endpunkt verwendet wird, an den der Agent Protokolle sendet. Wenn Sie dieses Feld angeben und einen privaten Link setzen, können Sie die Protokolle an einen Amazon-VPC-Endpunkt senden. Weitere Informationen finden Sie unter Was ist Amazon VPC?

    Der Wert von endpoint_override muss eine Zeichenkette sein, die eine URL ist.

    Beispielsweise legt der folgende Teil des Protokollabschnitts der Konfigurationsdatei fest, dass der Agent beim Senden von Protokollen einen VPC-Endpunkt verwendet. 

    {
  "logs": {
    "endpoint_override": "vpce-XXXXXXXXXXXXXXXXXXXXXXXXX.logs.us-east-1.vpce.amazonaws.com",
   ......
   },
}

  • force_flush_interval – Gibt die maximale Zeitspanne in Sekunden an, in der Protokolle im Speicherpuffer verbleiben, bevor sie an den Server gesendet werden. Unabhängig von der Einstellung für dieses Feld werden die Protokolle an den Server gesendet, sobald die Größe der Protokolle im Puffer 1 MB erreicht. Der Standardwert ist 5.

    Wenn Sie den Agenten verwenden, um hochauflösende Metriken im eingebetteten Metrikformat zu melden, und Sie Alarme für diese Metriken einstellen, belassen Sie diesen Parameter auf dem Standardwert von 5. Andernfalls werden die Metriken mit einer Verzögerung gemeldet, die bei unvollständigen oder unvollständigen Daten zu einer Alarmierung führen kann.

  • credentials— Gibt eine IAM-Rolle an, die beim Senden von Protokollen an ein anderes AWS Konto verwendet werden soll. Sofern angegeben, enthält dieses Feld einen Parameter, role_arn.

    • role_arn— Gibt den ARN einer IAM-Rolle an, der für die Authentifizierung verwendet werden soll, wenn Logs an ein anderes AWS Konto gesendet werden. Weitere Informationen finden Sie unter Metriken, Protokolle und Ablaufverfolgungen an ein anderes Konto senden. Wenn dieser Parameter hier angegeben wird, überschreibt er den Wert für role_arn im Abschnitt agent der Konfigurationsdatei, sofern vorhanden.

  • metrics_collected— Dieses Feld kann Abschnitte enthalten, in denen angegeben wird, dass der Agent Protokolle sammeln soll, um Anwendungsfälle wie CloudWatch Application Signals und Container Insights mit verbesserter Beobachtbarkeit für Amazon EKS zu ermöglichen.

    • application_signals(Optional) Gibt an, dass Sie CloudWatch Application Signals aktivieren möchten. Weitere Informationen zu dieser Konfiguration finden Sie unter CloudWatch Anwendungssignale aktivieren.

    • kubernetes – Dieses Feld kann einen enhanced_container_insights-Parameter enthalten, mit dem Sie Container Insights mit verbesserter Beobachtbarkeit für Amazon EKS aktivieren können.

      • enhanced_container_insights – Stellen Sie dies auf true ein, um Container Insights mit verbesserter Beobachtbarkeit für Amazon EKS zu aktivieren. Weitere Informationen finden Sie unter Container Insights mit verbesserter Beobachtbarkeit für Amazon EKS.

      • accelerated_compute_metrics— Stellen Sie diese Option ein, false um die Erfassung von Nvidia-GPU-Metriken auf Amazon EKS-Clustern zu deaktivieren. Weitere Informationen finden Sie unter NVIDIA GPU-Metriken.

    • emf – Um in Protokollen eingebettete Metriken zu erfassen, ist es nicht mehr erforderlich, dieses emf-Feld hinzuzufügen. Dies ist ein Legacy-Feld, das angibt, dass der Agent Protokolle im eingebetteten Metrikformat erfassen soll. Sie können Metrikdaten aus diesen Protokollen generieren. Weitere Informationen finden Sie unter Einbetten von Metriken in Protokollen.

    • otlp – Optional. Gibt an, dass Sie Metriken aus dem OpenTelemetry SDK sammeln möchten. Weitere Informationen zu den Feldern, die Sie in diesem Abschnitt verwenden können, finden Sie unterSammeln Sie Metriken und Traces mit OpenTelemetry.

Es folgt ein Beispiel für den Abschnitt logs.

"logs":
   {
       "logs_collected": {
           "files": {
               "collect_list": [
                   {
                       "file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log",
                       "log_group_name": "amazon-cloudwatch-agent.log",
                       "log_stream_name": "my_log_stream_name_1"
                   },
                   {
                       "file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\test.log",
                       "log_group_name": "test.log",
                       "log_stream_name": "my_log_stream_name_2"
                   }
               ]
           },
           "windows_events": {
               "collect_list": [
                   {
                       "event_name": "System",
                       "event_levels": [
                           "INFORMATION",
                           "ERROR"
                       ],
                       "log_group_name": "System",
                       "log_stream_name": "System"
                   },
                   {
                       "event_name": "CustomizedName",
                       "event_levels": [
                           "INFORMATION",
                           "ERROR"
                       ],
                       "log_group_name": "CustomizedLogGroup",
                       "log_stream_name": "CustomizedLogStream"
                   }
               ]
           }
       },
       "log_stream_name": "my_log_stream_name",
       "metrics_collected": {
           "kubernetes": {
                "enhanced_container_insights": true
      }
    }
  }

Indem Sie der CloudWatch Agentenkonfigurationsdatei einen traces Abschnitt hinzufügen, können Sie CloudWatch Application Signals aktivieren oder Traces von X-Ray und dem OpenTelemetry Instrumentierungs-SDK sammeln und an X-Ray senden.

Wichtig

Die IAM-Rolle oder der IAM-Benutzer des Agenten müssen über die AWSXrayWriteOnlyAccessRichtlinie verfügen, um Trace-Daten an X-Ray zu senden. Weitere Informationen finden Sie unter Erstellen Sie IAM-Rollen und -Benutzer für die Verwendung mit dem Agenten CloudWatch .

Für einen schnellen Start mit der Erfassung von Traces können Sie der CloudWatch Agenten-Konfigurationsdatei einfach Folgendes hinzufügen.

"traces_collected": {
        "xray": {
        },
        "otlp": {
        }
      }

Wenn Sie den vorherigen Abschnitt zur CloudWatch Agentenkonfigurationsdatei hinzufügen und den Agenten neu starten, beginnt der Agent mit der Erfassung von Traces mit den folgenden Standardoptionen und -werten. Weitere Informationen zu diesen Parametern finden Sie in den Parameterdefinitionen weiter unten in diesem Abschnitt.

"traces_collected": {
        "xray": {
            "bind_address": "127.0.0.1:2000",
            "tcp_proxy": {
              "bind_address": "127.0.0.1:2000"
            }
        },
        "otlp": {
            "grpc_endpoint": "127.0.0.1:4317",
            "http_endpoint": "127.0.0.1:4318"
        }
      }

Der Abschnitt traces kann die folgenden Felder enthalten:

  • traces_collected – Erforderlich, sofern der Abschnitt traces enthalten ist. Gibt an, von SDKs wem Traces gesammelt werden sollen. Dies kann die folgenden Felder umfassen:

    • application_signals Optional. Gibt an, dass Sie CloudWatch Application Signals aktivieren möchten. Weitere Informationen zu dieser Konfiguration finden Sie unter CloudWatch Anwendungssignale aktivieren.

    • xray Optional. Gibt an, dass Sie Ablaufverfolgungen aus dem X-Ray-SDK sammeln möchten. Dieser Abschnitt kann die folgenden Felder enthalten:

      • bind_address – Optional. Gibt die UDP-Adresse an, die der CloudWatch Agent verwenden soll, um auf Röntgen-Traces zu warten. Das Format ist ip:port. Diese Adresse muss mit der im X-Ray SDK eingestellten Adresse übereinstimmen.

        Wenn Sie dieses Feld auslassen, wird der Standard 127.0.0.1:2000 verwendet.

      • tcp_proxy Optional. Konfiguriert die Adresse für einen Proxy, der für die Unterstützung von X-Ray Remote Sampling verwendet wird. Weitere Informationen finden Sie unter Konfigurieren von Samplingregeln in der X-Ray-Dokumentation.

        Dieser Abschnitt kann das folgende Feld enthalten.

        • bind_address Optional. Gibt die TCP-Adresse an, für die der CloudWatch Agent den Proxy einrichten soll. Das Format ist ip:port. Diese Adresse muss mit der im X-Ray SDK eingestellten Adresse übereinstimmen.

          Wenn Sie dieses Feld auslassen, wird der Standard 127.0.0.1:2000 verwendet.

    • otlp Optional. Gibt an, dass Sie Traces vom OpenTelemetry SDK sammeln möchten. Weitere Informationen zu den Feldern, die Sie in diesem Abschnitt verwenden können, finden Sie unterSammeln Sie Metriken und Traces mit OpenTelemetry). Weitere Informationen zur AWS Distribution für finden Sie OpenTelemetry unter AWS Distribution for. OpenTelemetry Weitere Informationen zur AWS Distribution für OpenTelemetry SDKs finden Sie unter Einführung.

      Dieser Abschnitt kann die folgenden Felder enthalten:

      • grpc_endpoint – Optional. Gibt die Adresse an, die der CloudWatch Agent verwenden soll, um auf OpenTelemetry Traces zu warten, die mit gRPC Remote Procedure Calls gesendet wurden. Das Format ist ip:port. Diese Adresse muss mit der Adresse übereinstimmen, die für den gRPC-Exporter im OpenTelemetry SDK festgelegt wurde.

        Wenn Sie dieses Feld auslassen, wird der Standard 127.0.0.1:4317 verwendet.

      • http_endpoint Optional. Gibt die Adresse an, die der CloudWatch Agent verwenden soll, um auf OTLP-Traces zu warten, die über HTTP gesendet wurden. Das Format ist ip:port. Diese Adresse muss mit der Adresse übereinstimmen, die für den HTTP-Exporter im OpenTelemetry SDK festgelegt wurde.

        Wenn Sie dieses Feld auslassen, wird der Standard 127.0.0.1:4318 verwendet.

  • concurrency Optional. Gibt die maximale Anzahl der gleichzeitigen Aufrufe von X-Ray an, die zum Hochladen von Ablaufverfolgungen verwendet werden können. Der Standardwert ist 8

  • local_mode Optional. Fallstrue, sammelt der Agent keine EC2 Amazon-Instance-Metadaten. Der Standardwert ist false

  • endpoint_override Optional. Gibt einen FIPS-Endpunkt oder einen privaten Link an, der als Endpunkt verwendet werden soll, an den der CloudWatch Agent Traces sendet. Wenn Sie dieses Feld angeben und einen privaten Link setzen, können Sie die Ablaufverfolgung an einen Amazon-VPC-Endpunkt senden. Weitere Informationen finden Sie unter Was ist Amazon VPC

    Der Wert von endpoint_override muss eine Zeichenkette sein, die eine URL ist.

  • region_override Optional. Gibt die Region an, die für den X-Ray-Endpunkt verwendet werden soll. Der CloudWatch Agent sendet die Spuren in der angegebenen Region an X-Ray. Wenn Sie dieses Feld weglassen, sendet der Agent die Traces an die Region, in der sich die EC2 Amazon-Instance befindet.

    Wenn Sie hier eine Region angeben, hat diese Vorrang vor der Einstellung des region-Parameters im agent-Abschnitt der Konfigurationsdatei.

  • proxy_override Optional. Gibt die Proxy-Serveradresse an, die der CloudWatch Agent beim Senden von Anfragen an X-Ray verwenden soll. Das Protokoll des Proxyservers muss als Teil dieser Adresse angegeben werden.

  • credentials— Gibt eine IAM-Rolle an, die beim Senden von Traces an ein anderes AWS Konto verwendet werden soll. Sofern angegeben, enthält dieses Feld einen Parameter, role_arn.

    • role_arn— Gibt den ARN einer IAM-Rolle an, der für die Authentifizierung verwendet werden soll, wenn Traces an ein anderes AWS Konto gesendet werden. Weitere Informationen finden Sie unter Metriken, Protokolle und Ablaufverfolgungen an ein anderes Konto senden. Wenn dieser Parameter hier angegeben wird, überschreibt er den Wert für role_arn im Abschnitt agent der Konfigurationsdatei, sofern vorhanden.

  • transit_spans_in_otlp_format Optional. Wenntrue, sendet Traces im OpenTelemetry Protokollformat an X-Ray, das Span-Ereignisse in der Transaktionssuche unterstützt. Weitere Informationen finden Sie unter Hinzufügen von benutzerdefinierten Attributen. Der Standardwert ist false.

Im Folgenden finden Sie ein Beispiel für eine vollständige CloudWatch Agentenkonfigurationsdatei für einen Linux-Server.

Die Elemente, die in den measurement-Abschnitten für die zu sammelnden Metriken aufgelistet werden, können entweder den vollständigen Namen angeben oder nur den Teil des Metriknamens, der an den Typ der Ressource angehängt wird. Beispiel: Die Angabe von entweder reads oder diskio_reads im Abschnitt measurement des Abschnitts diskio bewirkt, dass die Metrik diskio_reads erfasst wird.

Dieses Beispiel enthält beide Möglichkeiten zur Angabe von Metriken im Bereich measurement.

    {
      "agent": {
        "metrics_collection_interval": 10,
        "logfile": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log"
      },
      "metrics": {
        "namespace": "MyCustomNamespace",
        "metrics_collected": {
          "cpu": {
            "resources": [
              "*"
            ],
            "measurement": [
              {"name": "cpu_usage_idle", "rename": "CPU_USAGE_IDLE", "unit": "Percent"},
              {"name": "cpu_usage_nice", "unit": "Percent"},
              "cpu_usage_guest"
            ],
            "totalcpu": false,
            "metrics_collection_interval": 10,
            "append_dimensions": {
              "customized_dimension_key_1": "customized_dimension_value_1",
              "customized_dimension_key_2": "customized_dimension_value_2"
            }
          },
          "disk": {
            "resources": [
              "/",
              "/tmp"
            ],
            "measurement": [
              {"name": "free", "rename": "DISK_FREE", "unit": "Gigabytes"},
              "total",
              "used"
            ],
             "ignore_file_system_types": [
              "sysfs", "devtmpfs"
            ],
            "metrics_collection_interval": 60,
            "append_dimensions": {
              "customized_dimension_key_3": "customized_dimension_value_3",
              "customized_dimension_key_4": "customized_dimension_value_4"
            }
          },
          "diskio": {
            "resources": [
              "*"
            ],
            "measurement": [
              "reads",
              "writes",
              "read_time",
              "write_time",
              "io_time"
            ],
            "metrics_collection_interval": 60
          },
          "swap": {
            "measurement": [
              "swap_used",
              "swap_free",
              "swap_used_percent"
            ]
          },
          "mem": {
            "measurement": [
              "mem_used",
              "mem_cached",
              "mem_total"
            ],
            "metrics_collection_interval": 1
          },
          "net": {
            "resources": [
              "eth0"
            ],
            "measurement": [
              "bytes_sent",
              "bytes_recv",
              "drop_in",
              "drop_out"
            ]
          },
          "netstat": {
            "measurement": [
              "tcp_established",
              "tcp_syn_sent",
              "tcp_close"
            ],
            "metrics_collection_interval": 60
          },
          "processes": {
            "measurement": [
              "running",
              "sleeping",
              "dead"
            ]
          }
        },
        "append_dimensions": {
          "ImageId": "${aws:ImageId}",
          "InstanceId": "${aws:InstanceId}",
          "InstanceType": "${aws:InstanceType}",
          "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
        },
        "aggregation_dimensions" : [["ImageId"], ["InstanceId", "InstanceType"], ["d1"],[]],
        "force_flush_interval" : 30
      },
      "logs": {
        "logs_collected": {
          "files": {
            "collect_list": [
              {
                "file_path": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
                "log_group_name": "amazon-cloudwatch-agent.log",
                "log_stream_name": "amazon-cloudwatch-agent.log",
                "timezone": "UTC"
              },
              {
                "file_path": "/opt/aws/amazon-cloudwatch-agent/logs/test.log",
                "log_group_name": "test.log",
                "log_stream_name": "test.log",
                "timezone": "Local"
              }
            ]
          }
        },
        "log_stream_name": "my_log_stream_name",
        "force_flush_interval" : 15,
        "metrics_collected": {
           "kubernetes": {
                "enhanced_container_insights": true
      }
    }
  }
}

Im Folgenden finden Sie ein Beispiel für eine vollständige CloudWatch Agentenkonfigurationsdatei für einen Server, auf dem Windows Server ausgeführt wird.

{
      "agent": {
        "metrics_collection_interval": 60,
        "logfile": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log"
      },
      "metrics": {
        "namespace": "MyCustomNamespace",
        "metrics_collected": {
          "Processor": {
            "measurement": [
              {"name": "% Idle Time", "rename": "CPU_IDLE", "unit": "Percent"},
              "% Interrupt Time",
              "% User Time",
              "% Processor Time"
            ],
            "resources": [
              "*"
            ],
            "append_dimensions": {
              "customized_dimension_key_1": "customized_dimension_value_1",
              "customized_dimension_key_2": "customized_dimension_value_2"
            }
          },
          "LogicalDisk": {
            "measurement": [
              {"name": "% Idle Time", "unit": "Percent"},
              {"name": "% Disk Read Time", "rename": "DISK_READ"},
              "% Disk Write Time"
            ],
            "resources": [
              "*"
            ]
          },
          "customizedObjectName": {
            "metrics_collection_interval": 60,
            "customizedCounterName": [
              "metric1",
              "metric2"
            ],
            "resources": [
              "customizedInstances"
            ]
          },
          "Memory": {
            "metrics_collection_interval": 5,
            "measurement": [
              "Available Bytes",
              "Cache Faults/sec",
              "Page Faults/sec",
              "Pages/sec"
            ]
          },
          "Network Interface": {
            "metrics_collection_interval": 5,
            "measurement": [
              "Bytes Received/sec",
              "Bytes Sent/sec",
              "Packets Received/sec",
              "Packets Sent/sec"
            ],
            "resources": [
              "*"
            ],
            "append_dimensions": {
              "customized_dimension_key_3": "customized_dimension_value_3"
            }
          },
          "System": {
            "measurement": [
              "Context Switches/sec",
              "System Calls/sec",
              "Processor Queue Length"
            ]
          }
        },
        "append_dimensions": {
          "ImageId": "${aws:ImageId}",
          "InstanceId": "${aws:InstanceId}",
          "InstanceType": "${aws:InstanceType}",
          "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
        },
        "aggregation_dimensions" : [["ImageId"], ["InstanceId", "InstanceType"], ["d1"],[]]
      },
      "logs": {
        "logs_collected": {
          "files": {
            "collect_list": [
              {
                "file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log",
                "log_group_name": "amazon-cloudwatch-agent.log",
                "timezone": "UTC"
              },
              {
                "file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\test.log",
                "log_group_name": "test.log",
                "timezone": "Local"
              }
            ]
          },
          "windows_events": {
            "collect_list": [
              {
                "event_name": "System",
                "event_levels": [
                  "INFORMATION",
                  "ERROR"
                ],
                "log_group_name": "System",
                "log_stream_name": "System",
                "event_format": "xml"
              },
              {
                "event_name": "CustomizedName",
                "event_levels": [
                  "WARNING",
                  "ERROR"
                ],
                "log_group_name": "CustomizedLogGroup",
                "log_stream_name": "CustomizedLogStream",
                "event_format": "xml"
              }
            ]
          }
        },
        "log_stream_name": "example_log_stream_name"
      }
    }

Speichern Sie die CloudWatch Agent-Konfigurationsdatei manuell

Wenn Sie die CloudWatch Agentenkonfigurationsdatei manuell erstellen oder bearbeiten, können Sie ihr einen beliebigen Namen geben. Anschließend können Sie die Datei auf andere Server kopieren, auf denen der Agent ausgeführt werden soll.

Anmerkung

Die CloudWatch Agentenkonfigurationsdatei in den Systems Manager Parameter Store hochladen

Wenn Sie den SSM-Agent verwenden möchten, um den CloudWatch Agenten auf Servern zu installieren, können Sie die CloudWatch Agentenkonfigurationsdatei nach der manuellen Bearbeitung in den Systems Manager Parameter Store hochladen. Verwenden Sie dazu den Systems Manager put-parameter-Befehl.

Zum Speichern der Datei in Parameter Store müssen Sie eine IAM-Rolle mit ausreichenden Berechtigungen verwenden. Weitere Informationen finden Sie unter Erstellen Sie IAM-Rollen und -Benutzer für die Verwendung mit dem Agenten CloudWatch .

Verwenden Sie den folgenden Befehl. Dabei parameter name handelt es sich um den Namen, der für diese Datei im Parameter Store verwendet werden soll, sowie configuration_file_pathname um den Pfad und den Dateinamen der Konfigurationsdatei, die Sie bearbeitet haben.

aws ssm put-parameter --name "parameter name" --type "String" --value file://configuration_file_pathname