

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.

# Amazon SWF-Metriken für CloudWatch
<a name="cw-metrics"></a>

Amazon SWF bietet jetzt Metriken CloudWatch , mit denen Sie Ihre Workflows und Aktivitäten verfolgen und Alarme für von Ihnen gewählte Schwellenwerte einrichten können. Sie können Metriken mit dem anzeigen AWS-Managementkonsole. Weitere Informationen finden Sie unter [Amazon SWF-Metriken für die CloudWatch Verwendung von anzeigen AWS-Managementkonsole](cw-metrics-console.md).

**Topics**
+ [Berichtseinheiten für Amazon SWF-Metriken](#swf-reporting-units)
+ [API- und Entscheidungsereignismetriken](#swf-throttling-metrics)
+ [Amazon SWF-Metriken](#cloudwatch-swf-metrics)
+ [Namen und Abmessungen von Amazon SWF SWF-Ressourcen ohne ASCII CloudWatch](#cloudwatch-swf-non-ascii)

## Berichtseinheiten für Amazon SWF-Metriken
<a name="swf-reporting-units"></a>

### Metriken, die ein Zeitintervall berichten
<a name="metrics-that-report-a-time-interval"></a>

Einige der Amazon SWF-Metriken für CloudWatch sind *Zeitintervalle*, die immer in Millisekunden gemessen werden. Die CloudWatch Einheit wird als gemeldet. `Time` Diese Metriken entsprechen in der Regel Phasen Ihrer Workflow-Ausführung, für die Sie Workflow- und Aktivitäts-Timeouts festlegen können, und besitzen ähnliche Namen.

Die Metrik `DecisionTaskStartToCloseTime` misst beispielsweise die Zeit, die die Entscheidungsaufgabe nach dem Ausführen bis zum Abschluss benötigte. Dies entspricht dem Zeitraum, für den Sie einen Wert `DecisionTaskStartToCloseTimeout` festlegen können.

Diagramme dieser Workflow-Stadien sowie weitere Informationen zu deren Auftreten im Workflow- und Aktivitätslebenszyklus finden Sie unter [Amazon SWF-Timeout-Typen](swf-timeout-types.md).

### Metriken, die eine Anzahl berichten
<a name="metrics-that-report-a-count"></a>

Einige der Amazon SWF-Metriken für CloudWatch Berichtsergebnisse als *Zählung*. `WorkflowsCanceled` erfasst beispielsweise ein Ergebnis entweder als *Eins* oder *Null*, was angibt, ob der Workflow abgebrochen wurde oder nicht. Der Wert Null gibt nicht an, dass die Metrik nicht gemeldet wurde, sondern nur, dass die von der Metrik beschriebene Bedingung nicht auftrat.

Bei einigen der Amazon SWF-Metriken für CloudWatch diesen Bericht a `Count` in CloudWatch handelt es sich um eine *Anzahl pro Sekunde*. Beispielsweise entspricht der Wert`ProvisionedRefillRate`, der als Ein `Count` gemeldet wird CloudWatch, einer *Rate* `Count` von Anfragen pro Sekunde.

Bei Zahl-Metriken beträgt der Mindest- und Maximalwert stets entweder Null oder Eins, doch der Durchschnittswert ist stets ein Wert zwischen Null bis Eins.

## API- und Entscheidungsereignismetriken
<a name="swf-throttling-metrics"></a>

 Sie können sowohl API- als auch Decision-Ereignisse überwachen CloudWatch , um einen Einblick in Ihre Nutzung und Kapazität zu erhalten. Weitere Informationen finden [Sie im [Grundlegende Workflow-Konzepte in Amazon SWF](swf-dg-basic.md) Abschnitt „Entscheider](swf-dev-actors.md#swf-dev-actors-deciders)“ und das Thema „[Entscheidung](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_Decision.html)“ in der [Amazon Simple Workflow Service API-Referenz.](https://docs.aws.amazon.com/amazonswf/latest/apireference/)

Sie können diese Grenzwerte auch überwachen, um einen Alarm auszulösen, wenn Sie sich Ihren Amazon SWF-Drosselungsgrenzwerten nähern. Unter [Drosselungskontingente für Amazon SWF](swf-dg-limits.md#swf-throttling-limits) finden Sie eine Beschreibung dieser Limits und ihrer Standardeinstellungen. Durch diese Limits soll verhindert werden, dass fehlerhafte Workflows Systemressourcen übermäßig verbrauchen. Informationen zur Erhöhung des Limits finden Sie unter [Beantragen einer Kontingenterhöhung](swf-dg-limits.md#swf-dg-limits-how-to-increase).

Als bewährte Methode sollten Sie CloudWatch Alarme für etwa 60% Ihrer API- oder Decision Events-Kapazität konfigurieren. Auf diese Weise können Sie entweder Ihren Workflow anpassen oder eine Erhöhung des Servicelimits beantragen, bevor die Amazon SWF-Drosselung aktiviert wird. Abhängig von der [Ruckartigkeit](https://en.wikipedia.org/wiki/Burstiness) Ihrer Aufrufe können Sie unterschiedliche Warnungen konfigurieren, die Sie informieren, wenn Sie sich Ihren Servicelimits nähern: 
+ Wenn Sie erhebliche Spitzen in Ihrem Datenverkehr haben, richten Sie eine Warnung bei 60 % Ihrer `ProvisionedBucketSize`-Limits ein.
+ Wenn Aufrufe relativ gleichmäßig eingehen, richten Sie eine Warnung bei 60 % Ihres `ProvisionedRefillRate`-Limits für die zugehörigen API- und Entscheidungsereignisse ein. 

## Amazon SWF-Metriken
<a name="cloudwatch-swf-metrics"></a>

Die folgenden Metriken sind für Amazon SWF verfügbar:


|  Metrik  |  Description  | 
| --- | --- | 
| `DecisionTaskScheduleToStartTime` | Zeitintervall in Millisekunden zwischen der Zeit, zu der die Entscheidungsaufgabe geplant worden ist, und der Zeit, zu der sie von einem Worker abgeholt und gestartet wird<br />CloudWatch Einheiten: `Time`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Average, Minimum, Maximum` | 
| `DecisionTaskStartToCloseTime` | Zeitintervall in Millisekunden zwischen der Start- und Abschlusszeit der Entscheidungsaufgabe<br />CloudWatch Einheiten: `Time`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Average, Minimum, Maximum` | 
| `DecisionTasksCompleted` | Anzahl der abgeschlossenen Entscheidungs-Tasks.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| PendingTasks | Die Anzahl der ausstehenden Aufgaben in einem 1-Minuten-Intervall für eine bestimmte Aufgabenliste.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, TaskListName`<br />Gültige Statistiken: `Sum` | 
| `StartedDecisionTasksTimedOutOnClose` | Anzahl der Entscheidungs-Tasks, die begonnen wurden, aber das Zeitlimit beim Abschließen überschritten haben.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `WorkflowStartToCloseTime` | Zeit in Millisekunden zwischen der Start- und Abschlusszeit des Workflows<br />CloudWatch Einheiten: `Time`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Average, Minimum, Maximum` | 
| `WorkflowsCanceled` | Anzahl der abgebrochenen Workflows.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `WorkflowsCompleted` | Anzahl der abgeschlossenen Workflows.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `WorkflowsContinuedAsNew` | Anzahl der Workflows, die als neue Workflows fortgesetzt worden sind.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `WorkflowsFailed` | Anzahl der fehlgeschlagenen Workflows<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `WorkflowsTerminated` | Anzahl der beendeten Workflows<br />CloudWatch Einheiten: `Count`<br />Maße: `Cause, Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `WorkflowsTimedOut` | Anzahl der Workflows, die aus irgendeinem Grund das Zeitlimit überschritten haben.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `ActivityTaskScheduleToCloseTime` | Zeitintervall in Millisekunden zwischen der Zeit, zu der die Aktivität geplant worden ist, und der Abschlusszeit der Aktivität<br />CloudWatch Einheiten: `Time`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Average, Minimum, Maximum` | 
| `ActivityTaskScheduleToStartTime` | Zeitintervall in Millisekunden zwischen der Zeit, zu der die Aktivitäts-Task geplant worden ist, und der Startzeit der Aktivitäts-Task.<br />CloudWatch Einheiten: `Time`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Average, Minimum, Maximum` | 
| `ActivityTaskStartToCloseTime` | Zeitintervall in Millisekunden zwischen der Start- und Abschlusszeit der Aktivitätsaufgabe<br />CloudWatch Einheiten: `Time`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Average, Minimum, Maximum` | 
| `ActivityTasksCanceled` | Anzahl der abgebrochenen Aktivitäts-Tasks.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `ActivityTasksCompleted` | Anzahl der abgeschlossenen Aktivitäts-Tasks.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `ActivityTasksFailed` | Anzahl der fehlgeschlagenen Aktivitäts-Tasks.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `ScheduledActivityTasksTimedOutOnClose` | Anzahl der Aktivitäts-Tasks, die geplant wurden, aber das Zeitlimit beim Abschließen überschritten haben.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `ScheduledActivityTasksTimedOutOnStart` | Anzahl der Aktivitäts-Tasks, die geplant wurden, aber das Zeitlimit beim Starten überschritten haben.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `StartedActivityTasksTimedOutOnClose` | Anzahl der Aktivitäts-Tasks, die begonnen wurden, aber das Zeitlimit beim Abschließen überschritten haben.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `StartedActivityTasksTimedOutOnHeartbeat` | Anzahl der Aktivitäts-Tasks, die begonnen wurden, aber das Zeitlimit infolge einer Heartbeat-Zeitüberschreitung überschritten haben.<br />CloudWatch Einheiten: `Count`<br />Maße: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Gültige Statistiken: `Sum` | 
| `ThrottledEvents` | Anzahl der gedrosselten Anforderungen<br />CloudWatch Einheiten: `Count`<br />Maße: `APIName, DecisionName, ThrottlingScope`<br />Gültige Statistiken: `Sum` | 
| `ProvisionedBucketSize` | Anzahl der verfügbaren Anforderungen pro Sekunde<br />Maße: `APIName, DecisionName`<br />Gültige Statistiken: `Minimum` | 
| `ConsumedCapacity` | Anzahl der Anforderungen pro Sekunde<br />CloudWatch Einheiten: `Count`<br />Maße: `APIName, DecisionName`<br />Gültige Statistiken: `Sum` | 
| ConsumedLimit | Die Menge des generellen Grenzwerts, der verbraucht wurde.<br />Maße: `GeneralLimitType` | 
| `ProvisionedRefillRate` | Anzahl der Anforderungen pro Sekunde für den Bucket<br />Maße: `APIName, DecisionName`<br />Gültige Statistiken: `Minimum` | 
| ProvisionedLimit | Der Betrag des allgemeinen Limits, der dem Konto zugewiesen wurde.<br />Maße: `GeneralLimitType` | 


|  Dimension  |  Description  | 
| --- | --- | 
| `Domain` | Filtert Daten in die Amazon SWF-Domain, in der der Workflow oder die Aktivität ausgeführt wird. | 
| `ActivityTypeName` | Filtert Daten nach dem Namen des Aktivitätstyps | 
| `ActivityTypeVersion` | Filtert Daten nach der Version des Aktivitätstyps | 
| `WorkflowTypeName` | Filtert Daten nach dem Namen des Workflow-Typs für diese Workflow-Ausführung | 
| `WorkflowTypeVersion` | Filtert Daten nach der Version des Workflow-Typs für diese Workflow-Ausführung | 
| `APIName` | Filtert Daten nach der API mit dem angegebenen API-Namen | 
| `DecisionName` | Filtert Daten nach dem angegebenen Entscheidungsnamen | 
| `TaskListName` | Filtert Daten auf den angegebenen Namen der Aufgabenliste. | 
| `TaskListClassification` | Filtert Daten entsprechend der Klassifizierung der Aufgabenliste. Der Wert ist „D“ für Aufgabenlisten mit Entscheidungen und „A“ für Aufgabenlisten mit Aktivitäten. | 
| `ThrottlingScope` | Filtert Daten bis zum angegebenen Einschränkungsbereich. Der Wert ist „Konto“, wenn das Kontingent auf Kontoebene überschritten wird, oder „Workflow“, wenn das Kontingent auf Workflow-Ebene überschritten wird. | 

## Namen und Abmessungen von Amazon SWF SWF-Ressourcen ohne ASCII CloudWatch
<a name="cloudwatch-swf-non-ascii"></a>

Amazon SWF erlaubt Nicht-ASCII-Zeichen in Ressourcennamen wie und. TaskList DomainName Die Dimensionswerte von CloudWatch Metriken können jedoch nur druckbare ASCII-Zeichen enthalten. Um sicherzustellen, dass Amazon SWF Dimensionswerte verwendet, die mit den [CloudWatch Anforderungen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Dimension.html) kompatibel sind, werden Amazon SWF SWF-Ressourcennamen, die diese Anforderungen nicht erfüllen, konvertiert und es wird eine Prüfsumme wie folgt angehängt: 
+ Jedes Nicht-ASCII-Zeichen wird durch ersetzt. `?` 
+ Die Eingabezeichenfolge oder die konvertierte Zeichenfolge wird, falls erforderlich, gekürzt. Dadurch wird sichergestellt, dass beim Anhängen der Prüfsumme die neue Zeichenkettenlänge das Maximum nicht überschreitet. CloudWatch
+ Da alle Nicht-ASCII-Zeichen in konvertiert werden, können einige CloudWatch metrische Dimensionswerte`?`, die vor der Konvertierung unterschiedlich waren, nach der Konvertierung identisch erscheinen. Zur besseren Unterscheidung wird an den Ressourcennamen ein Unterstrich (`_`) gefolgt von den ersten 16 Zeichen der SHA256 Prüfsumme des ursprünglichen Ressourcennamens angehängt.

Beispiele für Konvertierungen:
+ `test àpple`würde umgewandelt werden in `test ?pple_82cc5b8e3a771d12`
+ `àòà`würde umgewandelt werden in`???_2fec5edbb2c05c22`.
+ Die TaskList Namen `àpplé` und beide `âpplè` würden umgewandelt werden und wären identisch. `?ppl?` Das Anhängen der Prüfsumme gibt unterschiedliche Werte zurück, und`?ppl?_f39a36df9d85a69d`. `?ppl?_da3efb4f11dd0f7f`

**Tipp**  
Sie können Ihre eigene SHA256 Prüfsumme generieren. Um beispielsweise das `shasum` Befehlszeilentool zu verwenden:   
 **echo -n "<the original resource name>" \| shasum -a 256 \| cut -c1-16** 