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. # Einloggen und Überwachen AWS CodeBuild Die Protokollierung und Überwachung ist ein wichtiger Bestandteil der Aufrechterhaltung der Zuverlässigkeit, Verfügbarkeit AWS CodeBuild und Leistung Ihrer AWS Lösungen. Sie sollten Überwachungsdaten aus allen Teilen Ihrer AWS Lösung sammeln, damit Sie einen etwaigen Ausfall an mehreren Stellen leichter debuggen können. AWS bietet die folgenden Tools zur Überwachung Ihrer CodeBuild Ressourcen und Builds sowie zur Reaktion auf potenzielle Vorfälle. **Topics** + [ # AWS CodeBuild API-Aufrufe protokollieren mit AWS CloudTrail ](cloudtrail.md) + [ # Überwachen Sie CodeBuild Builds mit CloudWatch ](monitoring-builds.md) # AWS CodeBuild API-Aufrufe protokollieren mit AWS CloudTrail AWS CodeBuild ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die von einem Benutzer, einer Rolle oder einem AWS Dienst in ausgeführt wurden CodeBuild. CloudTrail erfasst alle API-Aufrufe CodeBuild als Ereignisse, einschließlich Aufrufe von der CodeBuild Konsole und von Codeaufrufen an die CodeBuild APIs. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Bereitstellung von CloudTrail Ereignissen an einen S3-Bucket aktivieren, einschließlich Ereignissen für CodeBuild. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen. Anhand der von gesammelten Informationen können Sie die Anfrage ermitteln CloudTrail, an die die Anfrage gestellt wurde CodeBuild, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Informationen. Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). **Topics** + [ # AWS CodeBuild Informationen zu Informationen in CloudTrail ](service-name-info-in-cloudtrail.md) + [ # Informationen zu Einträgen AWS CodeBuild in Protokolldateien ](understanding-service-name-entries.md) # AWS CodeBuild Informationen zu Informationen in CloudTrail CloudTrail ist in Ihrem AWS Konto aktiviert, wenn Sie das Konto erstellen. Wenn eine Aktivität in stattfindet CodeBuild, wird diese Aktivität zusammen mit anderen CloudTrail AWS Serviceereignissen im **Ereignisverlauf in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem AWS Konto ansehen, suchen und herunterladen. Weitere Informationen finden Sie im *AWS CloudTrail Benutzerhandbuch* unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS Konto, einschließlich der Ereignisse für CodeBuild, erstellen Sie einen Trail. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle -Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen S3-Bucket. Sie können andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie unter: + [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Alle CodeBuild Aktionen werden von der [CodeBuild API-Referenz](https://docs.aws.amazon.com/codebuild/latest/APIReference/) protokolliert CloudTrail und sind in dieser dokumentiert. Beispielsweise generieren Aufrufe der Aktionen `CreateProject` (in den AWS CLI,`create-project`), `StartBuild` (in der AWS CLI,`start-project`) und `UpdateProject` (in der AWS CLI,`update-project`) Einträge in den CloudTrail Protokolldateien. Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte: + Ob die Anforderung mit Root- oder -Benutzeranmeldeinformationen ausgeführt wurde. + Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde. + Ob die Anfrage von einem anderen AWS Dienst gestellt wurde. *Weitere Informationen finden Sie unter dem [Element CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) im AWS CloudTrail Benutzerhandbuch.* # Informationen zu Einträgen AWS CodeBuild in Protokolldateien Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden. **Anmerkung** Um vertrauliche Informationen zu schützen, sind die folgenden Informationen in CodeBuild Protokollen versteckt: AWS Zugriffsschlüssel IDs. Weitere Informationen finden Sie unter [Verwaltung von Zugriffsschlüsseln für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *AWS Identity and Access Management Benutzerhandbuch*. Mit dem Parameter Store angegebene Zeichenfolgen. Weitere Informationen finden Sie unter [Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html) und [Systems Manager Parameter Store Console Walkthrough](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-walk.html#sysman-paramstore-console) im *Amazon EC2 Systems Manager Manager-Benutzerhandbuch*. Zeichenketten, die angegeben wurden mit. AWS Secrets Manager Weitere Informationen finden Sie unter [Schlüsselverwaltung](security-key-management.md). Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die Erstellung eines Build-Projekts in demonstriert CodeBuild. ``` { "eventVersion": "1.05", "userIdentity": { "type": "FederatedUser", "principalId": "account-ID:user-name", "arn": "arn:aws:sts::account-ID:federated-user/user-name", "accountId": "account-ID", "accessKeyId": "access-key-ID", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2016-09-06T17:59:10Z" }, "sessionIssuer": { "type": "IAMUser", "principalId": "access-key-ID", "arn": "arn:aws:iam::account-ID:user/user-name", "accountId": "account-ID", "userName": "user-name" } } }, "eventTime": "2016-09-06T17:59:11Z", "eventSource": "codebuild.amazonaws.com", "eventName": "CreateProject", "awsRegion": "region-ID", "sourceIPAddress": "127.0.0.1", "userAgent": "user-agent", "requestParameters": { "awsActId": "account-ID" }, "responseElements": { "project": { "environment": { "image": "image-ID", "computeType": "BUILD_GENERAL1_SMALL", "type": "LINUX_CONTAINER", "environmentVariables": [] }, "name": "codebuild-demo-project", "description": "This is my demo project", "arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project:project-ID", "encryptionKey": "arn:aws:kms:region-ID:key-ID", "timeoutInMinutes": 10, "artifacts": { "location": "arn:aws:s3:::codebuild-region-ID-account-ID-output-bucket", "type": "S3", "packaging": "ZIP", "outputName": "MyOutputArtifact.zip" }, "serviceRole": "arn:aws:iam::account-ID:role/CodeBuildServiceRole", "lastModified": "Sep 6, 2016 10:59:11 AM", "source": { "type": "GITHUB", "location": "https://github.com/my-repo.git" }, "created": "Sep 6, 2016 10:59:11 AM" } }, "requestID": "9d32b228-745b-11e6-98bb-23b67EXAMPLE", "eventID": "581f7dd1-8d2e-40b0-aeee-0dbf7EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "account-ID" } ``` # Überwachen Sie CodeBuild Builds mit CloudWatch Sie können Amazon verwenden, CloudWatch um Ihre Builds zu beobachten, zu melden, wenn etwas nicht stimmt, und gegebenenfalls automatische Maßnahmen zu ergreifen. Sie können Ihre Builds auf zwei Ebenen überwachen: Projektebene Diese Metriken gelten für alle Builds im angegebenen Projekt. Um die Metriken für ein Projekt anzuzeigen, geben Sie `ProjectName` für die Dimension in CloudWatch an. AWS Kontoebene Diese Metriken gelten für alle Builds in einem Konto. Um Metriken auf der AWS -Kontoebene anzuzeigen, geben Sie keine Dimension in CloudWatch ein. Messwerte zur Nutzung von Build-Ressourcen sind auf AWS Kontoebene nicht verfügbar. CloudWatch Metriken zeigen das Verhalten Ihrer Builds im Laufe der Zeit. Beispielsweise können Sie Folgendes überwachen: + Wie viele Builds wurden im Laufe der Zeit in einem Build-Projekt oder einem AWS Account versucht? + Wie viele Builds waren im Laufe der Zeit in einem Build-Projekt oder einem AWS Account erfolgreich? + Wie viele Builds sind in einem Build-Projekt oder einem AWS Account im Laufe der Zeit gescheitert? + Wie viel Zeit wurde im Laufe der Zeit CodeBuild für die Ausführung von Builds in einem Build-Projekt oder einem AWS Account aufgewendet? + Nutzung der Build-Ressourcen für einen Build oder ein ganzes Build-Projekt. Zu den Kennzahlen zur Nutzung von Build-Ressourcen gehören Metriken wie CPU-, Arbeitsspeicher- und Speicherauslastung. Weitere Informationen finden Sie unter [CodeBuild Metriken anzeigen](monitoring-metrics.md). # CodeBuild CloudWatch Metriken Die folgenden Metriken können pro AWS Konto oder Build-Projekt nachverfolgt werden. Weitere Informationen zur Verwendung von CloudWatch with CodeBuild finden Sie unter[Überwachen Sie CodeBuild Builds mit CloudWatch](monitoring-builds.md). BuildDuration Misst die Dauer der `BUILD`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum Builds Misst die Anzahl der ausgelösten Builds. Einheiten: Anzahl Gültige CloudWatch Statistiken: Summe DownloadSourceDuration Misst die Dauer der `DOWNLOAD_SOURCE`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum Dauer Misst die Dauer aller Builds im Laufe der Zeit. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum FailedBuilds Misst die Anzahl der Builds, die aufgrund eines Client-Fehlers oder eines Timeouts fehlgeschlagen sind. Einheiten: Anzahl Gültige CloudWatch Statistiken: Summe FinalizingDuration Misst die Dauer der `FINALIZING`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum InstallDuration Misst die Dauer der `INSTALL`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum PostBuildDuration Misst die Dauer der `POST_BUILD`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum PreBuildDuration Misst die Dauer der `PRE_BUILD`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum ProvisioningDuration Misst die Dauer der `PROVISIONING`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum QueuedDuration Misst die Dauer der `QUEUED`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum SubmittedDuration Misst die Dauer der `SUBMITTED`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum SucceededBuilds Misst die Anzahl der erfolgreichen Builds. Einheiten: Anzahl Gültige CloudWatch Statistiken: Summe UploadArtifactsDuration Misst die Dauer der `UPLOAD_ARTIFACTS`-Phase des Builds. Einheiten: Sekunden Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum # CodeBuild CloudWatch Kennzahlen zur Ressourcennutzung **Anmerkung** CodeBuild Kennzahlen zur Ressourcennutzung sind nur in den folgenden Regionen verfügbar: Region Asien-Pazifik (Tokio) Region Asien-Pazifik (Seoul) Region Asien-Pazifik (Mumbai) Region Asien-Pazifik (Singapur) Region Asien-Pazifik (Sydney) Region Kanada (Zentral) Region Europa (Frankfurt) Region Europa (Irland) Region Europa (London) Region Europa (Paris) Region Südamerika (São Paulo) Region USA Ost (Nord-Virginia) Region USA Ost (Ohio) Region USA West (Nordkalifornien) Region USA West (Oregon) Die folgenden Kennzahlen zur Ressourcennutzung können nachverfolgt werden. Weitere Informationen zur Verwendung von CloudWatch with CodeBuild finden Sie unter[Überwachen Sie CodeBuild Builds mit CloudWatch](monitoring-builds.md). CPUUtilized Die Anzahl der CPU-Einheiten der zugewiesenen Verarbeitung, die vom Build-Container verwendet werden. Einheiten: CPU-Einheiten Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum CPUUtilizedProzent Der Prozentsatz der zugewiesenen Verarbeitung, der vom Build-Container verwendet wird. Einheiten: Prozent Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum MemoryUtilized Die Anzahl der Megabyte an Speicher, die vom Build-Container verwendet werden. Einheiten: Megabyte Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum MemoryUtilizedPercent Der Prozentsatz des zugewiesenen Speichers, der vom Build-Container verwendet wird. Einheiten: Prozent Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum StorageReadBytes Die vom Build-Container verwendete Speicherlesegeschwindigkeit. Einheiten: Byte/Sekunde Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum StorageWriteBytes Die vom Build-Container verwendete Speicher-Schreibgeschwindigkeit. Einheiten: Byte/Sekunde Gültige CloudWatch Statistiken: Durchschnitt (empfohlen), Maximum, Minimum # CodeBuild CloudWatch Abmessungen CodeBuild bietet die folgenden CloudWatch metrischen Abmessungen. Wenn keine dieser Angaben angegeben ist, beziehen sich die Metriken auf das AWS Girokonto. BuildId, BuildNumber, ProjectName Metriken werden für eine Build-ID, eine Build-Nummer und einen Projektnamen bereitgestellt. ProjectName Metriken werden für einen Projektnamen bereitgestellt. # CodeBuild CloudWatch Alarme Sie können die CloudWatch Konsole verwenden, um Alarme auf der Grundlage von CodeBuild Metriken zu erstellen, sodass Sie reagieren können, wenn bei Ihren Builds etwas schief geht. Die beiden Metriken, die bei Alarmen am nützlichsten sind, werden in den folgenden Aufzählungszeichen beschrieben. Weitere Informationen zur Verwendung von CloudWatch mit finden Sie CodeBuild unter[Überwachen Sie CodeBuild Builds mit CloudWatch](monitoring-builds.md). + `FailedBuild`. Sie können einen Alarm erstellen, der ausgelöst wird, wenn innerhalb einer bestimmten Anzahl von Sekunden eine bestimmte Anzahl von fehlgeschlagenen Builds erkannt wird. In CloudWatch geben Sie die Anzahl der Sekunden an und wie viele fehlgeschlagene Builds einen Alarm auslösen. + `Duration`. Sie können einen Alarm erstellen, der ausgelöst wird, wenn ein Build länger als erwartet dauert. Sie geben an, wie viele Sekunden vergehen müssen, nachdem ein Build gestartet wurde und bevor ein Build abgeschlossen wurde, bevor der Alarm ausgelöst wird. Informationen zum Erstellen von Alarmen für CodeBuild Metriken finden Sie unter[Überwachen Sie CodeBuild Gebäude mit CloudWatch Alarmen](monitoring-alarms.md). Weitere Informationen zu Alarmen finden Sie unter [ CloudWatch Amazon-Alarme erstellen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) im * CloudWatch Amazon-Benutzerhandbuch*. # CodeBuild Metriken anzeigen AWS CodeBuild überwacht Funktionen in Ihrem Namen und meldet Metriken über Amazon CloudWatch. Diese Metriken umfassen die Anzahl der gesamten Builds, fehlgeschlagene Builds, erfolgreiche Builds und die Dauer des Builds. Sie können die CodeBuild Konsole oder die CloudWatch Konsole verwenden, um Metriken für zu überwachen CodeBuild. Die folgenden Verfahren zeigen Ihnen, wie Sie Metriken anzeigen. **Topics** + [ ## Build-Metriken anzeigen (CodeBuild Konsole) ](#metrics-in-codebuild-console) + [ ## Build-Metriken anzeigen ( CloudWatch Amazon-Konsole) ](#metrics-in-cloudwatch-console) ## Build-Metriken anzeigen (CodeBuild Konsole) **Anmerkung** Sie können die Metriken oder die Diagramme, mit denen sie in der CodeBuild Konsole angezeigt werden, nicht anpassen. Wenn Sie die Anzeige anpassen möchten, verwenden Sie die CloudWatch Amazon-Konsole, um Ihre Build-Metriken einzusehen. ### Metriken auf Kontoebene **Um Metriken auf Kontoebene einzusehen AWS** 1. [Melden Sie sich bei AWS-Managementkonsole codebuild/home an https://console.aws.amazon.com/codesuite/ und öffnen Sie die AWS CodeBuild Konsole.](https://console.aws.amazon.com/codesuite/codebuild/home) 1. Wählen Sie im Navigationsbereich **Account metrics (Konto-Metriken)** aus. ### Metriken auf Projektebene **Um Metriken auf Projektebene anzuzeigen** 1. [Melden Sie sich bei AWS-Managementkonsole codebuild/home an https://console.aws.amazon.com/codesuite/ und öffnen Sie die AWS CodeBuild Konsole.](https://console.aws.amazon.com/codesuite/codebuild/home) 1. Wählen Sie im linken Navigationsbereich **Build projects** aus. 1. Wählen Sie in der Liste der Build-Projekte in der Spalte **Name** das Projekt aus, in dem Sie die Metriken anzeigen möchten. 1. Wählen Sie die Registerkarte **Metriken** aus. ## Build-Metriken anzeigen ( CloudWatch Amazon-Konsole) Sie können die Metriken und die Grafiken, die zu ihrer Anzeige verwendet werden, mit der CloudWatch Konsole anpassen. ### Metriken auf Kontoebene **Um Metriken auf Kontoebene einzusehen** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 1. Wählen Sie im Navigationsbereich **Metriken** aus. 1. Wählen Sie auf der Registerkarte **All metrics (Alle Metriken)** **CodeBuild** aus. ![\[So zeigen Sie CodeBuild Metriken an.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Wählen Sie **Account Metrics (Konto-Metriken)** aus. 1. Wählen Sie ein oder mehrere Projekte und eine oder mehrere Metriken. Für jedes Projekt können Sie die Metriken **SucceededBuilds**, **FailedBuilds**, **Builds** und **Duration** auswählen. Alle ausgewählten Projekt- und Metrik-Kombinationen werden in dem Diagramm auf der Seite angezeigt. ### Metriken auf Projektebene **Um Metriken auf Projektebene anzuzeigen** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 1. Wählen Sie im Navigationsbereich **Metriken** aus. 1. Wählen Sie auf der Registerkarte **All metrics (Alle Metriken)** **CodeBuild** aus. ![\[So zeigen Sie CodeBuild Metriken an.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Wählen Sie **By Project (Nach Projekt)**. 1. Wählen Sie eine oder mehrere Projekt- und Metrikkombinationen. Für jedes Projekt können Sie die Metriken **SucceededBuilds**, **FailedBuilds**, **Builds** und **Duration** auswählen. Alle ausgewählten Projekt- und Metrik-Kombinationen werden in dem Diagramm auf der Seite angezeigt. 1. (Optional) Sie können Ihre Metriken und Diagramme anpassen. Sie können beispielsweise aus der Drop-down-Liste in der Spalte **Statistik** eine andere Statistik auswählen, die angezeigt werden soll. Alternativ können Sie auch aus dem Dropdown-Menü in der Spalte **Period (Zeitraum)** einen anderen Zeitraum für die Überwachung der Metriken auswählen. Weitere Informationen finden Sie unter [Graph-Metriken](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) und [Verfügbare Metriken anzeigen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. # Kennzahlen CodeBuild zur Ressourcennutzung anzeigen AWS CodeBuild überwacht die Auslastung der Build-Ressourcen in Ihrem Namen und meldet Metriken über Amazon CloudWatch. Dazu gehören Metriken wie CPU-, Arbeitsspeicher- und Speicherauslastung. **Anmerkung** CodeBuild Messwerte zur Ressourcennutzung werden nur für Builds aufgezeichnet, die länger als eine Minute laufen. Sie können die CodeBuild Konsole oder die Konsole verwenden, um die CloudWatch Messwerte zur Ressourcennutzung für zu überwachen CodeBuild. **Anmerkung** CodeBuild Messwerte zur Ressourcennutzung sind nur in den folgenden Regionen verfügbar: Region Asien-Pazifik (Tokio) Region Asien-Pazifik (Seoul) Region Asien-Pazifik (Mumbai) Region Asien-Pazifik (Singapur) Region Asien-Pazifik (Sydney) Region Kanada (Zentral) Region Europa (Frankfurt) Region Europa (Irland) Region Europa (London) Region Europa (Paris) Region Südamerika (São Paulo) Region USA Ost (Nord-Virginia) Region USA Ost (Ohio) Region USA West (Nordkalifornien) Region USA West (Oregon) Die folgenden Verfahren zeigen Ihnen, wie Sie auf Ihre Kennzahlen zur Ressourcennutzung zugreifen können. **Topics** + [ ## Greifen Sie auf Kennzahlen zur Ressourcennutzung zu (CodeBuild Konsole) ](#utilization-metrics-codebuild-console) + [ ## Auf Kennzahlen zur Ressourcennutzung zugreifen ( CloudWatch Amazon-Konsole) ](#utilization-metrics-cloudwatch-console) ## Greifen Sie auf Kennzahlen zur Ressourcennutzung zu (CodeBuild Konsole) **Anmerkung** Sie können die Metriken oder die Diagramme, mit denen sie in der CodeBuild Konsole angezeigt werden, nicht anpassen. Wenn Sie die Anzeige anpassen möchten, verwenden Sie die CloudWatch Amazon-Konsole, um Ihre Build-Metriken einzusehen. ### Kennzahlen zur Ressourcennutzung auf Projektebene **Um auf Metriken zur Ressourcennutzung auf Projektebene zuzugreifen** 1. [Melden Sie sich bei AWS-Managementkonsole codebuild/home an https://console.aws.amazon.com/codesuite/ und öffnen Sie die AWS CodeBuild Konsole.](https://console.aws.amazon.com/codesuite/codebuild/home) 1. Wählen Sie im linken Navigationsbereich **Build projects** aus. 1. Wählen Sie in der Liste der Build-Projekte in der Spalte **Name** das Projekt aus, für das Sie die Nutzungsmetriken anzeigen möchten. 1. Wählen Sie die Registerkarte **Metriken** aus. Die Kennzahlen zur Ressourcennutzung werden im Abschnitt **Kennzahlen zur Ressourcenauslastung** angezeigt. 1. Um die Kennzahlen zur Ressourcennutzung auf Projektebene in der CloudWatch Konsole **anzuzeigen, wählen Sie CloudWatch im** Abschnitt Kennzahlen zur **Ressourcenauslastung** die Option Anzeigen aus. ### Kennzahlen zur Ressourcennutzung auf Build-Ebene **Um auf Metriken zur Ressourcennutzung auf Build-Ebene zuzugreifen** 1. [Melden Sie sich bei AWS-Managementkonsole codebuild/home an https://console.aws.amazon.com/codesuite/ und öffnen Sie die AWS CodeBuild Konsole.](https://console.aws.amazon.com/codesuite/codebuild/home) 1. Wählen Sie im Navigationsbereich **Build history** aus. 1. Wählen Sie in der Liste der Builds in der Spalte **Build run** den Build aus, für den Sie die Nutzungsmetriken anzeigen möchten. 1. Wählen Sie die Registerkarte **Ressourcenauslastung**. 1. Um die Kennzahlen zur Ressourcennutzung auf Build-Ebene in der CloudWatch Konsole **anzuzeigen, wählen Sie CloudWatch im** Abschnitt Kennzahlen zur **Ressourcenauslastung** die Option Anzeigen aus. ## Auf Kennzahlen zur Ressourcennutzung zugreifen ( CloudWatch Amazon-Konsole) Die CloudWatch Amazon-Konsole kann für den Zugriff auf Kennzahlen zur CodeBuild Ressourcennutzung verwendet werden. ### Kennzahlen zur Ressourcennutzung auf Projektebene **Um auf Metriken zur Ressourcennutzung auf Projektebene zuzugreifen** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 1. Wählen Sie im Navigationsbereich **Metriken** aus. 1. Wählen Sie auf der Registerkarte **All metrics (Alle Metriken)** **CodeBuild** aus. ![\[Screenshot der Konsole, der die CodeBuild Option auf der Registerkarte Alle Metriken zeigt.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Wählen Sie **By Project (Nach Projekt)**. 1. Wählen Sie eine oder mehrere Kombinationen aus Projekt und Metrik aus, um sie dem Diagramm hinzuzufügen. Alle ausgewählten Projekt- und Metrik-Kombinationen werden in dem Diagramm auf der Seite angezeigt. 1. (Optional) Sie können Ihre Metriken und Grafiken auf der Registerkarte **Graphische Kennzahlen** anpassen. Sie können beispielsweise aus der Drop-down-Liste in der Spalte **Statistik** eine andere Statistik für die Anzeige auswählen. Alternativ können Sie auch aus dem Dropdown-Menü in der Spalte **Period (Zeitraum)** einen anderen Zeitraum für die Überwachung der Metriken auswählen. Weitere Informationen finden Sie unter [Metriken grafisch darstellen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) und [Verfügbare Metriken anzeigen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. ### Kennzahlen zur Ressourcennutzung auf Build-Ebene **Um auf Metriken zur Ressourcennutzung auf Build-Ebene zuzugreifen** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 1. Wählen Sie im Navigationsbereich **Metriken** aus. 1. Wählen Sie auf der Registerkarte **All metrics (Alle Metriken)** **CodeBuild** aus. ![\[Screenshot der Konsole, der die CodeBuild Option auf der Registerkarte Alle Metriken zeigt.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Wählen Sie **BuildId, BuildNumber, ProjectName**. 1. Wählen Sie eine oder mehrere Kombinationen aus Build und Metrik aus, die Sie dem Diagramm hinzufügen möchten. Alle ausgewählten Kombinationen aus Build und Metrik werden im Diagramm auf der Seite angezeigt. 1. (Optional) Sie können Ihre Metriken und Grafiken auf der Registerkarte **Graphische Metriken** anpassen. Sie können beispielsweise aus der Drop-down-Liste in der Spalte **Statistik** eine andere Statistik für die Anzeige auswählen. Alternativ können Sie auch aus dem Dropdown-Menü in der Spalte **Period (Zeitraum)** einen anderen Zeitraum für die Überwachung der Metriken auswählen. Weitere Informationen finden Sie unter [Metriken grafisch darstellen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) und [Verfügbare Metriken anzeigen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. # Überwachen Sie CodeBuild Gebäude mit CloudWatch Alarmen Sie können einen CloudWatch Alarm für Ihre Builds erstellen. Ein Alarm überwacht eine Metrik über einen bestimmten, von Ihnen definierten Zeitraum und führt eine oder mehrere Aktionen durch, die vom Wert der Metrik im Verhältnis zu einem bestimmten Schwellenwert in einer Reihe von Zeiträumen abhängt. Mithilfe der systemeigenen CloudWatch Alarmfunktion können Sie alle Aktionen angeben, die CloudWatch bei Überschreitung eines Schwellenwerts unterstützt werden. Sie können beispielsweise festlegen, dass eine Amazon SNS SNS-Benachrichtigung gesendet wird, wenn mehr als drei Builds in Ihrem Konto innerhalb von fünfzehn Minuten fehlschlagen. **Um einen CloudWatch Alarm für eine Metrik zu erstellen CodeBuild** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Klicken Sie im Navigationsbereich auf **Alarms** (Alarme). 1. Wählen Sie **Create Alarm** (Alarm erstellen) aus. 1. Wählen Sie unter **CloudWatch Metriken nach Kategorie** die Option **CodeBuildMetriken** aus. Wenn Sie wissen, dass Sie nur Metriken auf Projektebene benötigen, wählen Sie **By Project (Nach Projekt)**. Wenn Sie wissen, dass Sie nur Metriken auf Kontoebene benötigen, wählen Sie **Account Metrics (Kontometriken)**. 1. Wählen Sie unter **Create Alarm (Alarm erstellen)** **Select Metric (Metrik auswahlen)**, falls es noch nicht ausgewählt ist. 1. Wählen Sie eine Metrik aus, für die Sie einen Alarm erstellen möchten. Die Optionen sind **By Project (Nach Projekt)** oder **Account Metrics (Konto-Metriken)**. 1. Wählen Sie **Next (Weiter)** und anschließend **Define Alarm (Alarm definieren)**, und erstellen Sie dann Ihren Alarm. Weitere Informationen finden Sie unter [ CloudWatch Amazon-Alarme erstellen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) im * CloudWatch Amazon-Benutzerhandbuch*. Weitere Informationen zum Einrichten von Amazon SNS SNS-Benachrichtigungen, wenn ein Alarm ausgelöst wird, finden Sie unter [Amazon SNS SNS-Benachrichtigungen einrichten im Amazon SNS *SNS-Entwicklerhandbuch*](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html). 1. Wählen Sie **Alarm erstellen** aus.