Erstellen oder bearbeiten Sie die CloudWatch Agenten-Konfigurationsdatei manuell

role_arn— Gibt den Amazon-Ressourcennamen (ARN) einer IAM-Rolle an, die für die Authentifizierung beim Senden von Metriken, Protokollen und Traces an ein anderes AWS Konto verwendet werden soll. Weitere Informationen finden Sie unter Metriken, Protokolle und Ablaufverfolgungen an ein anderes Konto senden.

LogDebug

LogDebugWithSigning

LogDebugWithHTTPBody

LogDebugRequestRetries

LogDebugWithEventStreamBody

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

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

"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.

cloudwatch— Amazon CloudWatch.

amp: Amazon Managed Service für Prometheus

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 mit Werten zu befüllen.

deployment.environment – Optional. Gibt den Umgebungsnamen an, der verwendet werden soll, um die Entität für die Suche nach zugehöriger Telemetrie mit Werten zu befüllen.

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 die Metriken nach Dimension nicht 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:

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 High-resolution 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.

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 die Metriken nach Dimension nicht 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 CloudWatch beschränkt die Erfassung von Metriken auf die aufgelisteten Mount-Points. 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.

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

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

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 High-resolution 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 festlegen.

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 die Metriken nach Dimension nicht 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 Geräten angeben, werden nur Metriken 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 von Diskio- und AWS NVMe-Treibermetriken an, die für Amazon EBS-Volumes und Instance-Speicher-Volumes erfasst werden sollen, die an Amazon EC2-Instances angehängt sind. Mögliche diskio-Werte sind reads, writes, read_bytes, write_bytes, read_time, write_time, io_time und iops_in_progress. Eine Liste der NVMe-Treibermetriken für Amazon-EBS-Volumes und Amazon-EC2-Instance-Speicher-Volumes finden Sie unter Erfassen von Amazon EBS-NVMe-Treibermetriken und Erfassen von NVMe-Treiber-Metriken der Amazon-EC2-Instance-Speicher-Volumes. 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:

Informationen zu Standardeinheiten und eine Beschreibung der Metriken finden Sie unter Erfassen von Amazon EBS-NVMe-Treibermetriken.

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 High-resolution 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.

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 die Metriken nach Dimension nicht 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-Instanzen gesammelte Metriken.

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

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 High-resolution 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.

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 die Metriken nach Dimension nicht 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, shared, 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-Instanzen gesammelte Metriken.

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

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 High-resolution 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.

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 die Metriken nach Dimension nicht 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-Instanzen gesammelte Metriken.

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

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 High-resolution 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.

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 die Metriken nach Dimension nicht 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-Instanzen gesammelte Metriken.

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

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 High-resolution 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.

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 die Metriken nach Dimension nicht 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:

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 High-resolution 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.

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 die Metriken nach Dimension nicht 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:

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.

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 die Metriken nach Dimension nicht 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 EFA-Metriken an, die erfasst werden sollen. Dies ist ein Pflichtfeld. Wenn Sie dieses Feld nicht angeben, gibt der Agent einen Fehler zurück. Sie können Metriknamen mit oder ohne efa_ Präfix angeben. Beispielsweise tx_bytes sind beide efa_tx_bytes und gültig.

Eine Liste der möglichen Werte, die Sie hier verwenden können, finden Sie in der Spalte Metric (Metrik) in der Tabelle unter Erfassen Sie EFA-Metriken.

metrics_collection_interval – Optional. Gibt an, wie oft die EFA-Metriken erfasst werden sollen, wobei die im agent Abschnitt der Konfigurationsdatei metrics_collection_interval angegebenen globalen Werte außer Kraft gesetzt werden. Der Standardwert liegt bei 60 Sekunden.

fd_release— Gibt bei Gegendruck Dateideskriptoren für gelöschte Dateien frei. Diese Option kann dazu beitragen, eine Erschöpfung des Festplattenspeichers zu verhindern, wenn externe Protokollrotations- oder Bereinigungsprozesse Dateien entfernen, während der Agent offene Dateideskriptoren beibehält. Die auto_removal Option hat Vorrang vor der Option, auf gesetzt istbackpressure_mode. fd_release Wenn diese Option aktiviert auto_removal ist, verarbeitet der CloudWatch Agent die Datei vollständig, ohne den Dateideskriptor freizugeben.

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

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

Verwenden Sie den journald Abschnitt, um anzugeben, welche Systemd-Journalprotokolle von Linux-Servern erfasst werden sollen. Verwenden Sie diesen Abschnitt nur für Linux-Instances. Er enthält folgende Felder:

Im folgenden Beispiel für eine Agentenkonfiguration:

"journald": {
    "collect_list": [
        {
            "log_group_name": "journald-all-logs",
            "log_stream_name": "{instance_id}",
            "retention_in_days": 7
        },
        {
            "log_group_name": "journald-sshd",
            "log_stream_name": "{instance_id}",
            "units": ["sshd"],
            "retention_in_days": 7
        },
        {
            "log_group_name": "journald-errors",
            "log_stream_name": "{instance_id}",
            "priority": "err",
            "retention_in_days": 7
        },
        {
            "log_group_name": "journald-root-logind",
            "log_stream_name": "{instance_id}",
            "units": ["systemd-logind"],
            "matches": [{"_UID": "0"}],
            "retention_in_days": 7
        },
        {
            "log_group_name": "journald-filters",
            "log_stream_name": "{instance_id}",
            "units": ["sshd"],
            "filters": [
                {
                    "type": "include",
                    "expression": ".*user.*"
                },
                {
                    "type": "exclude",
                    "expression": ".*successful.*"
                }
            ],
            "retention_in_days": 7
        }
    ]
}

role_arn— Gibt den ARN einer IAM-Rolle an, die für die Authentifizierung beim Senden von Protokollen an ein anderes AWS Konto verwendet werden soll. 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.

application_signals(Optional) Gibt an, dass Sie CloudWatch Anwendungssignale aktivieren möchten. Weitere Informationen zu dieser Konfiguration finden Sie unterCloudWatch 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.

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 über die Felder, die Sie in diesem Abschnitt verwenden können, finden Sie unter Erfassen Sie Metriken und Traces mit OpenTelemetry.

application_signals – Optional. Gibt an, dass Sie CloudWatch Anwendungssignale aktivieren möchten. Weitere Informationen zu dieser Konfiguration finden Sie unterCloudWatch Anwendungssignale aktivieren.

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

otlp – Optional. Gibt an, dass Sie Traces aus dem OpenTelemetry SDK sammeln möchten. Weitere Informationen über die Felder, die Sie in diesem Abschnitt verwenden können, finden Sie unter Erfassen Sie Metriken und Traces mit OpenTelemetry.) Weitere Informationen zur AWS Distribution für OpenTelemetry finden Sie unter AWS Distro für. OpenTelemetry Weitere Informationen zur AWS Distribution für OpenTelemetry SDKs finden Sie unter Einführung. https://aws-otel.github.io/docs/introduction

Dieser Abschnitt kann die folgenden Felder enthalten:

role_arn— Gibt den ARN einer IAM-Rolle an, die 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.

otlp – Optional. Gibt an, dass der Agent Metriken, Traces und Logs empfängt, die ihm über das OpenTelemetry Protokoll (OTLP) gesendet werden. Dieser Abschnitt kann die folgenden Felder enthalten:

files – Optional. Gibt an, dass der Agent Protokolldateien vom Host sammelt. Es enthält ein Feld,collect_list.

windows_events – Optional. Gibt an, dass der Agent Ereignisse aus dem Windows-Ereignisprotokoll sammelt. Diese Quelle ist nur auf Servern verfügbar, auf denen Windows Server ausgeführt wird. Sie enthält ein Feld,collect_list.

host_metrics – Optional. Gibt an, dass der Agent Systemmetriken auf Host-Ebene erfasst. Dieser Abschnitt kann das folgende Feld enthalten:

prometheus – Optional. Gibt an, dass der Agent Metriken von Prometheus-Zielen entfernt. Dieser Abschnitt kann das folgende Feld enthalten: