Überwachung von AWS CodeBuild

Sie können Amazon CloudWatch verwenden, um Ihre Builds zu überwachen, Fehler zu melden und gegebenenfalls automatisch Maßnahmen zu ergreifen. Sie können Ihre Builds auf zwei Ebenen überwachen:

Ebene des Projekts

Diese Metriken gelten für alle Builds im angegebenen Projekt. Um Metriken für ein Projekt anzuzeigen, geben SieProjectNamefür die Dimension in CloudWatch.

AWSKonto-Level

Diese Metriken gelten für alle Builds in einem -Konto. Um Metriken auf derAWS-Kontoebene, geben Sie keine Dimension in CloudWatch ein. Metriken für die Build-Ressourcennutzung sind imAWSKonto-Level.

CloudWatch-Metriken zeigen das Verhalten Ihrer Builds im Laufe der Zeit. Beispielsweise können Sie Folgendes überwachen:

• Wie viele Builds in einem Build-Projekt oder einem AWS-Konto im Laufe der Zeit versucht wurden.

• Wie viele Builds in einem Build-Projekt oder einem AWS-Konto im Laufe der Zeit erfolgreich erstellt wurden.

• Wie viele Builds in einem Build-Projekt oder einem AWS-Konto im Laufe der Zeit fehlgeschlagen haben.

• Wie viel Zeit CodeBuild zur Ausführung von Builds in einem Build-Projekt oder einemAWS-Konto im Laufe der Zeit.

• Erstellen Sie die Ressourcenauslastung für einen Build oder ein ganzes Build-Projekt. Metriken zur Build-Ressourcenauslastung umfassen Metriken wie z B. CPU, Arbeitsspeicher und Speicherauslastung.

Weitere Informationen finden Sie unter Überwachung von CodeBuild-Metriken.

CodeBuild-CloudWatch-Metriken

Die folgenden Metriken können proAWS-Konto oder Build-Projekt.

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 von Builds, die fehlgeschlagen haben, weil ein Client-Fehler oder ein Timeout auftritt.

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-Metriken zur Ressourcennutzung

Anmerkung

CodeBuild-Metriken zur Ressourcennutzung sind nur in den folgenden Regionen verfügbar:

• Asia Pacific (Tokyo) Region

• Asia Pacific (Seoul) Region

• Region Asien-Pazifik (Mumbai)

• Asia Pacific (Singapore) Region

• Asia Pacific (Sydney) Region

• Region Kanada (Zentral)

• Region Europa (Frankfurt)

• Europe (Ireland) Region

• Europe (London) Region

• Region Europa (Paris)

• South America (São Paulo) Region

• US East (N. Virginia) Region

• US East (Ohio) Region

• US West (N. California) Region

• US West (Oregon) Region

Die folgenden Metriken zur Ressourcennutzung können verfolgt werden.

CPUUtilized

Die Anzahl von CPU-Einheiten der zugewiesenen Verarbeitung, die vom Build-Container verwendet werden.

Einheiten: CPU-Einheiten

Gültige CloudWatch-Statistiken Durchschnitt (empfohlen), Maximum, Minimum

CpuUused Percent

Der Prozentsatz der zugewiesenen Verarbeitung, die vom Build-Container verwendet wird.

Einheiten: Prozent

Gültige CloudWatch-Statistiken Durchschnitt (empfohlen), Maximum, Minimum

MemoryUtilized

Die Anzahl von Megabyte an Speicherplatz, der vom Build-Container verwendet wird.

Einheiten: Megabytes

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 Lesegeschwindigkeit des Speichers.

Einheiten: Byte/Sekunde

Gültige CloudWatch-Statistiken Durchschnitt (empfohlen), Maximum, Minimum

StorageWriteBytes

Die vom Build-Container verwendete Schreibgeschwindigkeit des Speichers.

Einheiten: Byte/Sekunde

Gültige CloudWatch-Statistiken Durchschnitt (empfohlen), Maximum, Minimum

CodeBuild-CloudWatch-Abmessungen

CodeBuild bietet die folgenden CloudWatch-Metrik-Dimensionen. Wenn keine davon angegeben ist, gelten die Metriken für die aktuelleAWSKonto.

BuildId, buildNumber, ProjectName

Metriken werden für einen Build-Bezeichner, eine Build-Nummer und einen Projektnamen bereitgestellt.

ProjectName

Für einen Projektnamen werden Metriken bereitgestellt.

CodeBuild-CloudWatch-Alarme

Sie können die CloudWatch-Konsole verwenden, um Alarme basierend auf CodeBuild-Metriken zu erstellen. Auf diese Weise können Sie reagieren, wenn ein Problem mit Ihren Builds auftritt. Die beiden praktischsten Metriken mit Alarmen sind:

• FailedBuildaus. Sie können einen Alarm einrichten, der ausgelöst wird, wenn eine bestimmte Anzahl von fehlgeschlagenen Builds innerhalb einer festgelegten Anzahl von Sekunden erkannt wird. In CloudWatch geben Sie die Anzahl der Sekunden an und wie viele fehlgeschlagene Builds einen Alarm auslösen.

• Durationaus. Sie können einen Alarm einrichten, der ausgelöst wird, wenn ein Build länger dauert als erwartet. 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.

Weitere Informationen zum Erstellen von Alarmen für CodeBuild-Metriken finden Sie unterÜberwachen von Builds mit CloudWatch-Alarmenaus. Weitere Informationen über Alarme finden Sie unterErstellen von Amazon CloudWatch CloudWatch-AlarmenimAmazon CloudWatch-Benutzerhandbuchaus.