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.
# Ressourcen überwachen und kennzeichnen AWS Elemental MediaTailor
Die Überwachung ist ein wichtiger Bestandteil der Aufrechterhaltung der Zuverlässigkeit, Verfügbarkeit und Leistung Ihrer anderen AWS Elemental MediaTailor Lösungen. AWS AWS bietet die folgenden Überwachungstools, mit denen Sie beobachten MediaTailor, melden können, wenn etwas nicht stimmt, und gegebenenfalls automatische Maßnahmen ergreifen können:
+ *Amazon CloudWatch* überwacht Ihre AWS Ressourcen und die Anwendungen, auf denen Sie laufen, AWS in Echtzeit. Sie können Kennzahlen erfassen und verfolgen, benutzerdefinierte Dashboards erstellen und Alarme festlegen, die Sie benachrichtigen oder Maßnahmen ergreifen, wenn eine bestimmte Metrik einen von Ihnen festgelegten Schwellenwert erreicht. Sie können beispielsweise die CPU-Auslastung oder andere Kennzahlen Ihrer Amazon EC2 EC2-Instances CloudWatch verfolgen und bei Bedarf automatisch neue Instances starten. Weitere Informationen finden Sie im [ CloudWatch Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
+ Mit *Amazon CloudWatch Logs* können Sie Ihre Protokolldateien aus allen Interaktionen mit Ihrem Ad Decision Server (ADS) überwachen, speichern und darauf zugreifen. AWS Elemental MediaTailor sendet Protokolle für Anzeigenanfragen, Weiterleitungen und Antworten sowie für Berichtsanfragen und -antworten aus. Fehler von den ADS- und Ursprungsservern werden auch an Protokollgruppen in Amazon ausgegeben CloudWatch. MediaTailor bietet auch Informationen zu übersprungenen Anzeigen und den Gründen, warum sie übersprungen wurden. Weitere Informationen finden Sie unter [Fehlerbehebung beim Überspringen von Anzeigen](troubleshooting-ad-skipping-overview.md). Sie können Ihre Protokolldaten auch in einem sehr robusten Speicher archivieren. Allgemeine Informationen finden Sie im [Amazon CloudWatch Logs-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). Informationen zu den ADS-Protokollen und wie Sie auf sie für Analysen über Amazon CloudWatch Logs Insights zugreifen können, finden Sie unter[AWS Elemental MediaTailor ADS-Protokollanalyse in Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md).
**Topics**
+ [AWS Elemental MediaTailor Protokolle anzeigen](monitoring-through-logs.md)
+ [Überwachung AWS Elemental MediaTailor mit CloudWatch Amazon-Metriken](monitoring-cloudwatch-metrics.md)
+ [AWS Elemental MediaTailor API-Aufrufe aufzeichnen](logging-using-cloudtrail.md)
+ [Empfangen von Benachrichtigungen zur AWS Elemental MediaTailor Kanalmontage](channel-assembly-alerts.md)
+ [Ressourcen taggen AWS Elemental MediaTailor](tagging.md)
+ [Überwachung von AWS Mediendiensten mit Workflow-Monitor](monitor-with-workflow-monitor.md)
# AWS Elemental MediaTailor Protokolle anzeigen
MediaTailor sendet Protokolle aus, die eine Vielzahl von Meilensteinen und Aktivitäten in Kanälen und Wiedergabekonfigurationen beschreiben. Sie können diese Protokolle verwenden, um sich einen Überblick über Ihren Arbeitsablauf zu verschaffen und Probleme mit dem Service zu beheben. In den folgenden Themen werden Protokolle und Protokollierungsoptionen beschrieben.
**Topics**
+ [ADS-Protokolle](ads-log-format.md)
+ [Manifest-Protokolle](log-types.md)
+ [Protokolle transkodieren](tm-log-format.md)
+ [Verwendung von verkauften Protokollen](vended-logs.md)
+ [Protokolle in CloudWatch Logs schreiben](monitoring-cw-logs.md)
+ [Steuerung des Volumens der Sitzungsprotokolle zur Anzeigeneinfügung](log-configuration.md)
+ [Filterung von Protokollen und Ereignissen](logs-filter.md)
+ [Debug-Protokolle generieren](debug-log-mode.md)
# AWS Elemental MediaTailor Beschreibung und Ereignistypen der ADS-Protokolle
In den folgenden Abschnitten werden die Protokolle beschrieben, MediaTailor die zur Beschreibung von Ereignissen mit dem AD Decision Server (ADS) ausgegeben werden. Dies sind `AdDecisionServerInteractions` Protokolle.
**Topics**
+ [AdDecisionServerInteractions-Ereignisse](#log-types-adsinteraction)
+ [Beschreibung des ADS-Protokolls](#ads-log-description)
+ [JSON-Schema für das ADS-Protokoll](#ads-log-json-schema)
## AdDecisionServerInteractions-Ereignisse
Die folgenden Ereignisse werden bei MediaTailor Interaktionen mit dem Ad Decision Server (ADS) ausgelöst.
| Protokoll | Description |
| --- | --- |
| AD\$1MARKER\$1FOUND | MediaTailor Ich habe eine Werbemarkierung im Manifest gefunden. |
| BEACON\$1FIRED | Ein Tracking-Beacon wurde ausgelöst, um Werbeereignisse zu melden. MediaTailor Feuert das Beacon im serverseitigen Berichtsmodus (Standard) ab. Im clientseitigen Berichtsmodus feuert das Wiedergabegerät den Beacon ab. |
| EMPTY\$1VAST\$1RESPONSE | Das ADS gab eine leere VAST-Antwort zurück, die keine Werbung enthielt. |
| EMPTY\$1VMAP\$1RESPONSE | Das ADS hat eine leere VMAP-Antwort zurückgegeben. |
| ERROR\$1ADS\$1INVALID\$1RESPONSE | Das ADS hat einen Statuscode zurückgegeben, der nicht 200 ist. |
| ERROR\$1ADS\$1IO | MediaTailor Beim Versuch, mit dem ADS zu kommunizieren, ist ein Fehler aufgetreten. |
| ERROR\$1ADS\$1RESPONSE\$1PARSE | MediaTailor ist beim Analysieren der ADS-Antwort auf einen Fehler gestoßen. |
| ERROR\$1ADS\$1RESPONSE\$1UNKNOWN\$1ROOT\$1ELEMENT | Die ADS-Antwort enthält ein ungültiges Stammelement. |
| ERROR\$1ADS\$1TIMEOUT | Bei der MediaTailor Anfrage an das ADS wurde das Zeitlimit überschritten. |
| ERROR\$1DISALLOWED\$1HOST | Der ADS-Host ist nicht zulässig. |
| ERROR\$1FIRING\$1BEACON\$1FAILED | MediaTailor konnte das Tracking-Beacon nicht abfeuern. |
| ERROR\$1PERSONALIZATION\$1DISABLED | Das Einfügen von Anzeigen ist für diese Sitzung deaktiviert. |
| ERROR\$1UNKNOWN | MediaTailor ist bei der ADS-Anfrage auf einen unbekannten Fehler gestoßen. |
| ERROR\$1UNKNOWN\$1HOST | Der ADS-Host ist unbekannt. |
| ERROR\$1VAST\$1INVALID\$1MEDIA\$1FILE | Das Ad VAST-Objekt enthält ein ungültiges oder MediaFile fehlendes Element. |
| ERROR\$1VAST\$1INVALID\$1VAST\$1AD\$1TAG\$1URI | Die VAST-Antwort enthält ein ungültigesVASTAdTagURI. |
| ERROR\$1VAST\$1MISSING\$1CREATIVES | Das VAST Ad enthält null oder mehrere Creatives Elemente. Genau ein Creatives Element ist erforderlich. |
| ERROR\$1VAST\$1MISSING\$1IMPRESSION | Das VAST Ad enthält keine Impression Elemente. Es ist mindestens ein Impression Element erforderlich. |
| ERROR\$1VAST\$1MISSING\$1MEDIAFILES | Das VAST Ad enthält null oder mehrere MediaFiles Elemente. Genau ein MediaFiles Element ist erforderlich. |
| ERROR\$1VAST\$1MISSING\$1OVERLAYS | MediaTailor hat keine nichtlinearen Werbeanzeigen vom Ad-Server erhalten. |
| ERROR\$1VAST\$1MULTIPLE\$1LINEAR | Das VAST Ad enthält mehrere Linear Elemente. |
| ERROR\$1VAST\$1MULTIPLE\$1TRACKING\$1EVENTS | Das VAST Ad enthält mehrere TrackingEvents Elemente. |
| ERROR\$1VAST\$1REDIRECT\$1EMPTY\$1RESPONSE | Die VAST-Umleitungsanfrage gab eine leere Antwort zurück. |
| ERROR\$1VAST\$1REDIRECT\$1FAILED | Bei der VAST-Umleitungsanfrage ist ein Fehler aufgetreten. |
| ERROR\$1VAST\$1REDIRECT\$1MULTIPLE\$1VAST | Bei der VAST-Weiterleitungsanfrage wurden mehrere Anzeigen zurückgegeben. |
| FILLED\$1AVAIL | MediaTailor Der Vorrat wurde erfolgreich ausgefüllt. |
| FILLED\$1OVERLAY\$1AVAIL | MediaTailor Das Overlay-Angebot wurde erfolgreich ausgefüllt. |
| INTERSTITIAL\$1VOD\$1FAILURE | Bei der ADS-Anfrage oder -Antwort ist beim Ausfüllen der Interstitial-Avails für die VOD-Wiedergabeliste ein Problem aufgetreten. Es werden keine Anzeigen eingefügt. |
| INTERSTITIAL\$1VOD\$1SUCCESS | MediaTailor Interstitielle Avails für die VOD-Playlist wurden erfolgreich ausgefüllt. |
| MAKING\$1ADS\$1REQUEST | MediaTailor fordert Werbung von der ADS an. |
| MODIFIED\$1TARGET\$1URL | MediaTailor hat die ausgehende Ziel-URL geändert. |
| NON\$1AD\$1MARKER\$1FOUND | MediaTailor Ich habe im Manifest eine Werbemarkierung gefunden, die nicht bearbeitet werden kann. |
| RAW\$1ADS\$1RESPONSE | MediaTailor hat eine unformatierte ADS-Antwort erhalten. |
| REDIRECTED\$1VAST\$1RESPONSE | MediaTailor erhielt eine VAST-Antwort, nachdem ich der VAST-Weiterleitung gefolgt war. |
| VAST\$1REDIRECT | Die VAST-Anzeigenantwort enthält eine Weiterleitung. |
| VAST\$1RESPONSE | MediaTailor hat eine VAST-Antwort erhalten. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1SUCCESS | MediaTailor erfolgreich einen zeitbasierten Verfügbarkeitsplan für die VOD-Vorlage erstellt. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1VAST\$1RESPONSE\$1FOR\$1OFFSET | MediaTailor erstellt einen zeitbasierten Nutzungsplan für die VOD-Vorlage. MediaTailor hat eine VAST-Antwort für den Zeitversatz erhalten. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1WARNING\$1NO\$1ADVERTISEMENTS | Bei der ADS-Anfrage oder -Antwort ist beim Erstellen eines zeitbasierten Verfügbarkeitsplans für die VOD-Vorlage ein Problem aufgetreten. Es werden keine Anzeigen eingefügt. |
| WARNING\$1NO\$1ADVERTISEMENTS | MediaTailor ist beim Ausfüllen des Formulars auf ein Problem gestoßen. Es wurden keine Anzeigen eingefügt. |
| WARNING\$1URL\$1VARIABLE\$1SUBSTITUTION\$1FAILED | MediaTailor kann dynamische Variablen in der ADS-URL nicht ersetzen. Überprüfen Sie die URL-Konfiguration. |
| WARNING\$1VPAID\$1AD\$1DROPPED | Eine VPAID-Anzeige wurde aufgrund eines fehlenden Slate gelöscht, oder die Sitzung verwendet serverseitige Berichte. |
## Beschreibung des ADS-Protokolls
In diesem Abschnitt werden die Struktur und der Inhalt der ADS-Protokollbeschreibung beschrieben. Um sich selbst in einem JSON-Editor zu beschäftigen, verwenden Sie die Auflistung unter [JSON-Schema für das ADS-Protokoll](#ads-log-json-schema).
Jedes Ereignis im ADS-Protokoll enthält die Standardfelder, die von CloudWatch Logs generiert werden. Weitere Informationen finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html).
### ADS protokolliert Eigenschaften
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle beschrieben.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| adsRequestUrl | Zeichenfolge | false | Die vollständige URL der ADS-Anfrage von MediaTailor. |
| avail | Objekt des Typs [avail](#ads-logs-avail) | false | Informationen zu einem Angebot, das voller MediaTailor Werbung ist. Derzeit ist dies für den FILLED\$1AVAIL Ereignistyp der Plan, der erstellt wird, MediaTailor wenn er zum ersten Mal auf den Erfolg stößt. Wie der avail letztendlich gefüllt wird, kann sich von diesem Plan unterscheiden, je nachdem, wie die Inhalte abgespielt werden. |
| awsAccountId | Zeichenfolge | true | Die AWS-Konto-ID für die MediaTailor Konfiguration, die für die Sitzung verwendet wurde. |
| customerId | Zeichenfolge | true | Die gehashte Version der AWS-Konto-ID, die Sie verwenden können, um mehrere Protokolleinträge zu korrelieren. |
| eventDescription | Zeichenfolge | true | Eine kurze Beschreibung des Ereignisses, das diese Protokollnachricht ausgelöst hat, bereitgestellt vom MediaTailor Service. Standardmäßig ist dieses Feld leer. Beispiel: Got VAST response. |
| eventTimestamp | Zeichenfolge | true | Das Datum und die Uhrzeit des Ereignisses. |
| eventType | Zeichenfolge | true | Der Code für das Ereignis, das diese Protokollnachricht ausgelöst hat. Beispiel: VAST\$1RESPONSE. |
| originId | Zeichenfolge | true | Der Konfigurationsname aus der MediaTailor Konfiguration. Dies unterscheidet sich von der Quelle der Videoinhalte, die ebenfalls Teil der Konfiguration ist. |
| prefetchScheduleName | Zeichenfolge | false | Der Name des Prefetch-Zeitplans, der mit diesem Werbeereignis verknüpft ist. |
| requestHeaders | Array vom Typ [requestheaders](#ads-logs-requestheaders) | false | Die Header, die in der MediaTailor ADS-Anfrage enthalten waren. In der Regel enthalten die Protokolle diese, wenn eine Anforderung an den ADS fehlschlägt, um die Fehlerbehebung zu unterstützen. |
| requestId | Zeichenfolge | true | Die MediaTailor Anforderungs-ID, mit der Sie mehrere Protokolleinträge für dieselbe Anfrage korrelieren können. |
| sessionId | Zeichenfolge | true | Die eindeutige numerische Kennung, die MediaTailor der Spielersitzung zugewiesen wurde. Alle Anforderungen, die ein Spieler für eine Sitzung stellt, haben dieselbe Sitzungs-ID. Beispiel: e039fd39-09f0-46b2-aca9-9871cc116cde. |
| sessionType | Zeichenfolge (zulässige Werte: [DASH, HLS]) | true | Der Stream-Typ des Spielers. |
| vastAd | Objekt des Typs [vastAd](#ads-logs-vastAd) | false | Informationen zu einer einzelnen Anzeige, die aus der VAST-Antwort analysiert wurde. |
| vastResponse | Objekt des Typs [vastResponse](#ads-logs-vastResponse) | false | Informationen über die VAST-Antwort, die vom ADS MediaTailor empfangen wurde. |
| vodCreativeOffsets | Objekt des Typs [vodCreativeOffsets](#ads-logs-vodCreativeOffsets) | false | Eine Karte, die die Zeitversätze im Manifest angibt, bei denen Avails auf der Grundlage der VMAP-Antwort eingefügt MediaTailor werden. |
| vodVastResponseTimeOffset | number | false | Der VMAP-spezifische Zeitversatz zum Einfügen der VOD-Anzeige. |
### adContent
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle adContent beschrieben.
**Eigenschaften der ADS-Protokolle adContent**
| Eigenschaft | Typ | Erforderlich | Description |
| --- | --- | --- | --- |
| adPlaylistUris | Objekt des Typs [adPlaylistUris](#ads-logs-adPlaylistUris) | false | Die Zuordnung vom Ursprungsmanifest für eine Variante zum Anzeigenmanifest für die Variante. Für DASH enthält dies einen einzelnen Eintrag, da alle Varianten in einem einzigen DASH-Manifest dargestellt werden. |
### adPlaylistUris
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle beschrieben adPlaylistUris.
**adPlaylistUris Eigenschaften von ADS-Protokollen**
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| | Zeichenfolge | false | Die URL des Anzeigenmanifests für die spezifische Variante. |
### avail
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle avail beschrieben.
**Eigenschaften der ADS-Protokolle avail**
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| availId | Zeichenfolge | true | Die eindeutige Kennung für diese avail-Protokoll. Bei HLS ist dies die Mediensequenznummer, bei der der avail beginnt. Für DASH ist dies die Punkt-ID. |
| creativeAds | Array vom Typ [creativeAd](#ads-logs-creativeAd) | true | Die Anzeigen, die in den Avail MediaTailor eingefügt wurden. |
| fillRate | number | true | Die Rate, mit der die Anzeigen die avail-Dauer erfüllen, von 0,0 (für 0 %) bis 1,0 (für 100 %). |
| filledDuration | number | true | Die Summe der Dauer aller Anzeigen, die in avail eingefügt wurden. |
| numAds | number | true | Die Anzahl der Anzeigen, die in den Avail MediaTailor eingefügt wurden. |
| originAvailDuration | number | true | Die Dauer des avails, wie im Inhalts-Stream vom Ursprung angegeben (CUE\$1OUT oder SCTE). |
| skippedAds | Array vom Typ [skippedAd](#ads-logs-skippedAd) | false | Die Anzeigen, die aus Gründen wie TRANSCODE\$1IN\$1PROGRESS und MediaTailor TRANSCODE\$1ERROR nicht eingefügt wurden. Eine Liste der Gründe, warum Werbung übersprungen wurde, finden Sie unter[Fehlerbehebung beim Überspringen von Anzeigen](troubleshooting-ad-skipping-overview.md). |
| slateAd | Objekt des Typs [slateAd](#ads-logs-slateAd) | true | Informationen zur Slate-Anzeige, mit MediaTailor der alle nicht ausgefüllten Segmente aufgefüllt werden. |
### creativeAd
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle creativeAd beschrieben.
**Eigenschaften der ADS-Protokolle creativeAd**
| Eigenschaft | Typ | Erforderlich | Description |
| --- | --- | --- | --- |
| adContent | Objekt des Typs [adContent](#ads-logs-adContent) | true | Informationen über den Inhalt der eingefügten Anzeige. |
| creativeUniqueId | Zeichenfolge | true | Die eindeutige Kennung für die Anzeige, die als Schlüssel für die Transcodierung verwendet wird. Dies ist das ID-Feld für das Werbemittel in der VAST-Antwort, sofern verfügbar. Andernfalls handelt es sich um die Mezzanine-URL der Anzeige. |
| trackingEvents | Objekt des Typs [trackingEvents](#ads-logs-trackingEvents) | true | Das Tracking-Beacon URLs für die verschiedenen Tracking-Ereignisse für die Anzeige. Die Schlüssel sind die Namen der Ereignisse, und die Werte sind eine Liste von Beacons URLs. |
| transcodedAdDuration | number | true | Die Dauer der Anzeige, berechnet aus der transcodierten Komponente. |
| uri | Zeichenfolge | true | Die URL der Mezzanine-Version der Anzeige, bei der es sich um die Eingabe für den Transcoder handelt. |
| vastDuration | number | true | Die Dauer der Anzeige, wie aus der VAST-Antwort analysiert. |
### requestheaders
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle requestheaders beschrieben.
**Eigenschaften der ADS-Protokolle requestheaders**
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| name | Zeichenfolge | true | Der Name des hinzuzufügenden Headers. |
| value | Zeichenfolge | true | Der Wert des Headers |
### skippedAd
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle skippedAd beschrieben.
**Eigenschaften der ADS-Protokolle skippedAd**
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| adMezzanineUrl | Zeichenfolge | true | Die Mezzanine-URL der übersprungenen Anzeige. |
| creativeUniqueId | Zeichenfolge | true | Die eindeutige Kennung für die Anzeige, die als Schlüssel für die Transcodierung verwendet wird. Dies ist das ID-Feld für das Werbemittel in der VAST-Antwort, sofern verfügbar. Andernfalls handelt es sich um die Mezzanine-URL der Anzeige. |
| skippedReason | Zeichenfolge | true | Der Code, der angibt, warum die Anzeige nicht eingefügt wurde. Beispiel: TRANSCODE\$1IN\$1PROGRESS. Eine Liste der Gründe, warum Werbung übersprungen wurde, finden Sie unter. [Fehlerbehebung beim Überspringen von Anzeigen](troubleshooting-ad-skipping-overview.md) |
| transcodedAdDuration | number | false | Die Dauer der Anzeige, berechnet aus der transcodierten Komponente. |
| vastDuration | number | true | Die Dauer der Anzeige, wie aus der VAST-Antwort analysiert. |
### slateAd
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle slateAd beschrieben.
**Eigenschaften der ADS-Protokolle slateAd**
| Eigenschaft | Typ | Erforderlich | Description |
| --- | --- | --- | --- |
| adContent | Objekt des Typs [adContent](#ads-logs-adContent) | true | Informationen über den Inhalt der eingefügten Anzeige. |
| creativeUniqueId | Zeichenfolge | true | Die eindeutige Kennung für die Anzeige, die als Schlüssel für die Transcodierung verwendet wird. Dies ist das ID-Feld für das Werbemittel in der VAST-Antwort, sofern verfügbar. Andernfalls handelt es sich um die Mezzanine-URL der Anzeige. |
| transcodedAdDuration | number | true | Die Dauer der Anzeige, berechnet aus der transcodierten Komponente. |
| uri | Zeichenfolge | true | Die URL der Mezzanine-Version der Anzeige, bei der es sich um die Eingabe für den Transcoder handelt. |
### trackingEvents
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle trackingEvents beschrieben.
**Eigenschaften der ADS-Protokolle trackingEvents**
| Eigenschaft | Typ | Erforderlich | Description |
| --- | --- | --- | --- |
| | Array vom Typ Zeichenfolge | false | Die Liste der Beacons URLs für das angegebene Tracking-Ereignis (Impression, abgeschlossen usw.) |
### vastAd
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle vastAd beschrieben.
**Eigenschaften der ADS-Protokolle vastAd**
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| adSystem | Zeichenfolge | true | Der Wert des AdSystem-Tags in der VAST-Antwort. |
| adTitle | Zeichenfolge | true | Die Mediendateien, die für die Anzeige in der VAST-Antwort verfügbar sind. |
| creativeAdId | Zeichenfolge | true | Der Wert des adId-Attributs des Creative-Tags in der VAST-Antwort. |
| creativeId | Zeichenfolge | true | Der Wert des id-Attributs des Creative-Tags in der VAST-Antwort. |
| duration | number | true | Die ungefähre Dauer der Anzeige, basierend auf dem duration-Tag im linear-Element der VAST-Antwort. |
| trackingEvents | Objekt des Typs [trackingEvents](#ads-logs-trackingEvents) | true | Das Tracking-Beacon URLs für die verschiedenen Tracking-Ereignisse für die Anzeige. Die Schlüssel sind die Namen der Ereignisse, und die Werte sind eine Liste von Beacons URLs. |
| vastAdId | Zeichenfolge | true | Der Wert des id-Attributs des Ad-Tags in der VAST-Antwort |
| vastAdTagUri | Zeichenfolge | false | Die VMAP-spezifische Umleitungs-URI für eine Anzeige. |
| vastMediaFiles | Array vom Typ [vastMediaFile](#ads-logs-vastMediaFile) | true | Die Liste der verfügbaren Mediendateien für die Anzeige in der VAST-Antwort. |
### vastMediaFile
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle beschrieben vastMediaFile.
**vastMediaFile Eigenschaften von ADS-Protokollen**
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| apiFramework | Zeichenfolge | true | Das API-Framework, das für die Verwaltung der Mediendatei erforderlich ist. Beispiel: VPAID. |
| bitrate | number | true | Die Bitrate der Mediendatei. |
| delivery | Zeichenfolge | true | Das Protokoll, das für die Mediendatei verwendet wird, ist auf progressiv oder Streaming festgelegt. |
| height | number | true | Die Pixelhöhe der Mediendatei. |
| id | Zeichenfolge | true | Der Wert des id-Attributs des MediaFile-Tags. |
| type | Zeichenfolge | true | Der MIME-Typ der Mediendatei aus dem type-Attribut des MediaFile-Tags. |
| uri | Zeichenfolge | true | Die URL der Mezzanine-Version der Anzeige, bei der es sich um die Eingabe für den Transcoder handelt. |
| width | number | true | Die Pixelbreite der Mediendatei. |
### vastResponse
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle vastResponse beschrieben.
**Eigenschaften der ADS-Protokolle vastResponse**
| Eigenschaft | Typ | Erforderlich | Description |
| --- | --- | --- | --- |
| errors | Array vom Typ Zeichenfolge | true | Der Fehler URLs wurde anhand der Error Tags in der VAST-Antwort analysiert. |
| vastAds | Array vom Typ [vastAd](#ads-logs-vastAd) | true | Die Anzeigen, die aus der VAST-Antwort analysiert wurden. |
| version | Zeichenfolge | true | Die VAST-Spezifikationsversion, die aus dem version-Attribut des VAST-Tags in der Antwort analysiert wird. |
### vodCreativeOffsets
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle beschrieben vodCreativeOffsets.
**vodCreativeOffsets Eigenschaften von ADS-Protokollen**
| Eigenschaft | Typ | Erforderlich | Description |
| --- | --- | --- | --- |
| | Array vom Typ [vodCreativeOffset](#ads-logs-vodCreativeOffset) | false | Eine Zuordnung von einem Zeitversatz im Manifest zu einer Liste von Anzeigen, die zu diesem Zeitpunkt eingefügt werden sollen. |
### vodCreativeOffset
In diesem Abschnitt werden die Eigenschaften der ADS-Protokolle beschrieben vodCreativeOffset.
**vodCreativeOffset Eigenschaften von ADS-Protokollen**
| Eigenschaft | Typ | Erforderlich | Description |
| --- | --- | --- | --- |
| adContent | Objekt des Typs [adContent](#ads-logs-adContent) | true | Informationen über den Inhalt der eingefügten Anzeige. |
| creativeUniqueId | Zeichenfolge | true | Die eindeutige Kennung für die Anzeige, die als Schlüssel für die Transcodierung verwendet wird. Dies ist das ID-Feld für das Werbemittel in der VAST-Antwort, sofern verfügbar. Andernfalls handelt es sich um die Mezzanine-URL der Anzeige. |
| trackingEvents | Objekt des Typs [trackingEvents](#ads-logs-trackingEvents) | true | Das Tracking-Beacon URLs für die verschiedenen Tracking-Ereignisse für die Anzeige. Die Schlüssel sind die Namen der Ereignisse, und die Werte sind eine Liste von Beacons URLs. |
| transcodedAdDuration | number | true | Die Dauer der Anzeige, berechnet aus der transcodierten Komponente. |
| uri | Zeichenfolge | true | Die URL der Mezzanine-Version der Anzeige, bei der es sich um die Eingabe für den Transcoder handelt. |
| vastDuration | number | true | Die Dauer der Anzeige, wie aus der VAST-Antwort analysiert. |
## JSON-Schema für das ADS-Protokoll
Im Folgenden ist das JSON-Schema für das AWS Elemental MediaTailor ADS-Protokoll aufgeführt.
```
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "http://amazon.com/elemental/midas/mms/adsLogSchema.json",
"type": "object",
"title": "AWS Elemental MediaTailor ADS Log JSON Schema",
"required": [
"eventType",
"eventTimestamp",
"requestId",
"sessionType",
"eventDescription",
"awsAccountId",
"customerId",
"originId",
"sessionId"
],
"additionalProperties": false,
"properties": {
"eventType": {
"$id": "#/properties/eventType",
"type": "string",
"description": "The code for the event that triggered this log message. Example: VAST_RESPONSE.",
"examples": [
"FILLED_AVAIL"
]
},
"eventTimestamp": {
"$id": "#/properties/eventTimestamp",
"type": "string",
"description": "The date and time of the event.",
"examples": [
"1970-01-01T00:00:00Z"
],
"format": "date-time"
},
"requestId": {
"$id": "#/properties/requestId",
"type": "string",
"description": "The MediaTailor request ID, which you can use to correlate multiple log entries for the same request.",
"examples": [
"c7c7ae8c-a61e-44e0-8efd-7723995337a1"
],
"pattern": "^(.*)$"
},
"sessionType": {
"$id": "#/properties/sessionType",
"type": "string",
"enum": [
"HLS",
"DASH"
],
"description": "The player's stream type."
},
"eventDescription": {
"$id": "#/properties/eventDescription",
"type": "string",
"description": "A short description of the event that triggered this log message, provided by the MediaTailor service. By default, this is empty. Example: Got VAST response.",
"default": "",
"examples": [
"Got VAST response"
],
"pattern": "^(.*)$"
},
"awsAccountId": {
"$id": "#/properties/awsAccountId",
"type": "string",
"description": "The AWS account ID for the MediaTailor configuration that was used for the session."
},
"customerId": {
"$id": "#/properties/customerId",
"type": "string",
"description": "The hashed version of the AWS account ID, which you can use to correlate multiple log entries.",
"pattern": "^(.*)$"
},
"originId": {
"$id": "#/properties/originId",
"type": "string",
"description": "The configuration name from the MediaTailor configuration. This is different from the video content source, which is also part of the configuration.",
"examples": [
"external-canary-dash-serverside-reporting-onebox"
],
"pattern": "^(.*)$"
},
"sessionId": {
"$id": "#/properties/sessionId",
"type": "string",
"description": "The unique numeric identifier that MediaTailor assigned to the player session. All requests that a player makes for a session have the same session ID. Example: e039fd39-09f0-46b2-aca9-9871cc116cde.",
"examples": [
"120b9873-c007-40c8-b3db-0f1bd194970b"
],
"pattern": "^(.*)$"
},
"avail": {
"$id": "#/properties/avail",
"type": "object",
"title": "avail",
"description": "Information about an avail that MediaTailor fills with ads. Currently, for the FILLED_AVAIL event type, this is the plan created by MediaTailor when it first encounters the avail. How the avail is eventually filled may vary from this plan, depending on how the content plays out. ",
"required": [
"creativeAds",
"originAvailDuration",
"filledDuration",
"fillRate",
"driftMillisecondsAtAvailStart",
"numAds",
"slateAd",
"availId"
],
"additionalProperties": false,
"properties": {
"originAvailDuration": {
"$id": "#/properties/avail/originAvailDuration",
"type": "number",
"description": "The duration of the avail as specified in the content stream from the origin (CUE_OUT or SCTE)."
},
"filledDuration": {
"$id": "#/properties/avail/filledDuration",
"type": "number",
"description": "The sum of the durations of all the ads inserted into the avail."
},
"fillRate": {
"$id": "#/properties/avail/fillRate",
"type": "number",
"description": "The rate at which the ads fill the avail duration, from 0.0 (for 0%) to 1.0 (for 100%)."
},
"driftMillisecondsAtAvailStart": {
"$id": "#/properties/avail/driftMillisecondsAtAvailStart",
"type": "number",
"description": "The cumulative drift at the beginning of this avail. A positive value implies that we are moving away from the live edge, a negative value implies that we are moving towards the live edge."
},
"creativeAds": {
"$id": "#/properties/avail/creativeAds",
"type": "array",
"description": "The ads that MediaTailor inserted into the avail.",
"items": {
"type": "object",
"title": "creativeAd",
"description": "Information about a single inserted ad.",
"required": [
"uri",
"creativeUniqueId",
"adSystem",
"adContent",
"trackingEvents",
"vastDuration",
"transcodedAdDuration"
],
"additionalProperties": false,
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adSystem": { "$ref": "#/definitions/adSystem" },
"adContent": { "$ref": "#/definitions/adContent" },
"trackingEvents": { "$ref": "#/definitions/trackingEvents" },
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
}
}
},
"numAds": {
"$id": "#/properties/avail/numAds",
"type": "number",
"description": "The number of ads that MediaTailor inserted into the avail."
},
"slateAd": {
"$id": "#/properties/avail/slateAd",
"type": ["object", "null"],
"title": "slateAd",
"description": "Information about the slate ad, which MediaTailor uses to fill any unfilled segments in the avail.",
"additionalProperties": false,
"required": [
"uri",
"creativeUniqueId",
"adContent",
"transcodedAdDuration"
],
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adContent": { "$ref": "#/definitions/adContent" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
}
},
"availId": {
"$id": "#/properties/avail/availId",
"type": "string",
"description": "The unique identifier for this avail. For HLS, this is the media sequence number where the avail begins. For DASH, this is the period ID."
},
"skippedAds": {
"$id": "#/properties/avail/skippedAds",
"type": "array",
"description": "The ads that MediaTailor didn't insert, for reasons like TRANSCODE_IN_PROGRESS and TRANSCODE_ERROR.",
"items": {
"type": "object",
"title": "skippedAd",
"description": "Information about a single skipped ad.",
"required": [
"creativeUniqueId",
"adMezzanineUrl",
"skippedReason",
"vastDuration"
],
"additionalProperties": false,
"properties": {
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adMezzanineUrl": {
"type": "string",
"description": "The mezzanine URL of the skipped ad."
},
"skippedReason": {
"type": "string",
"description": "The code that indicates why the ad wasn't inserted. Example: TRANSCODE_IN_PROGRESS."
},
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
"targetVariant": {
"type": "object",
"title": "targetVariant",
"description": "The target variant of the source content. This key is present when an ad wasn't inserted due to the source content containing a variant that could not match to any variants present in this ad.",
"required": [
"mediaProtocol",
"mediaType",
"bitrate",
"mediaResolution",
"codecs"
],
"additionalProperties": false,
"properties": {
"mediaProtocol": {
"type": "string",
"description": "The media protocol of this variant, such as HLS.",
"enum": [
"HLS",
"DASH"
]
},
"mediaType": {
"type": "array",
"description": "The media type of this variant, such as VIDEO.",
"items": {
"type": "string",
"enum": [
"VIDEO",
"AUDIO",
"SUBTITLES",
"TRICK_PLAY"
],
"description": "Media type, such as VIDEO."
}
},
"bitrate": {
"$ref": "#/definitions/bitrate"
},
"mediaResolution": {
"type": "object",
"title": "mediaResolution",
"description": "The media resolution of this variant.",
"required": [
"width",
"height"
],
"additionalProperties": false,
"properties": {
"width": {
"$ref": "#/definitions/width"
},
"height": {
"$ref": "#/definitions/height"
}
}
},
"codecs": {
"type": "array",
"description": "The codecs of this variant.",
"items": {
"type": "string",
"description": "Codec, such as avc1."
}
}
}
}
}
}
},
"adBreakTrackingEvents": {
"$id": "#properties/avail/adBreakTrackingEvents",
"type": "object",
"title": "adBreakTrackingEvents",
"description": "VMAP/ad break tracking events and corresponding URL",
"properties": {
"items": {
"$ref": "#/definitions/adBreakTrackingEvents"
}
}
}
}
},
"vastResponse": {
"$id": "#/properties/vastResponse",
"type": "object",
"title": "vastResponse",
"description": "Information about the VAST response that MediaTailor received from the ADS.",
"required": [
"version",
"vastAds",
"errors",
"nonLinearAdsList"
],
"additionalProperties": false,
"properties": {
"version": {
"$id": "#/properties/vastResponse/version",
"type": "string",
"description": "The VAST specification version, parsed from the version attribute of the VAST tag in the response.",
"examples": [
"3.0"
],
"pattern": "^(.*)$"
},
"vastAds": {
"$id": "#/properties/vastResponse/vastAds",
"type": "array",
"description": "The ads parsed from the VAST response.",
"items": {
"$ref": "#/definitions/vastAd"
}
},
"errors": {
"$id": "#/properties/vastResponse/errors",
"type": "array",
"description": "The error URLs parsed from the Error tags in the VAST response.",
"items": {
"type": "string",
"description": "A single error URL."
}
},
"nonLinearAdsList": {
"$id": "#/properties/vastResponse/nonLinearAds",
"type": "array",
"description": "A list of NonLinearAds as they are read from the VAST response.",
"items": {
"$ref": "#/definitions/nonLinearAds"
}
}
}
},
"vastAd": {
"$ref": "#/definitions/vastAd"
},
"vodVastResponseTimeOffset": {
"$id": "#/properties/vodVastResponseTimeOffset",
"type": "number",
"description": "The VMAP specific time offset for VOD ad insertion.",
"examples": [
5.0
]
},
"vodCreativeOffsets": {
"$id": "#/properties/vodCreativeOffsets",
"type": "object",
"title": "vodCreativeOffsets",
"description": "A map that indicates the time offsets in the manifest where MediaTailor will insert avails, based on the VMAP response.",
"additionalProperties": {
"type": "array",
"$id": "#/properties/vodCreativeOffsets/entry",
"description": "A mapping from a time offset in the manifest to a list of ads to insert at this time.",
"items": {
"type": "object",
"$id": "#/properties/vodCreativeOffsets/entry/items",
"title": "vodCreativeOffset",
"description": "The list of ads to insert at the specified time offset.",
"additionalProperties": false,
"required": [
"uri",
"creativeUniqueId",
"vastDuration",
"transcodedAdDuration",
"adContent",
"trackingEvents"
],
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
"adContent": { "$ref": "#/definitions/adContent" },
"trackingEvents": { "$ref": "#/definitions/trackingEvents" }
}
}
}
},
"adsRequestUrl": {
"$id": "#/properties/adsRequestUrl",
"type": "string",
"description": "The full URL of the ADS request made by MediaTailor."
},
"adMarkers": {
"$id": "#/properties/adMarkers",
"type": "string",
"description": "Found Ad Marker in the Manifest."
},
"segmentationUpid": {
"$id": "#/properties/segmentationUpid",
"type": "string",
"description": "Value of segmentation upid parsed from ad markers in manifest."
},
"segmentationTypeId": {
"$id": "#/properties/segmentationTypeId",
"type": "integer",
"description": "Value of segmentation typeId parsed from ad markers in manifest."
},
"requestHeaders": {
"$id": "#/properties/requestHeaders",
"type": "array",
"description": "The headers that MediaTailor included with the ADS request. Typically, the logs include these when a request to the ADS fails, to help with troubleshooting.",
"items": {
"type": "object",
"title": "requestheaders",
"description": "The name and value for a single header included in the ADS request.",
"required": [
"name",
"value"
],
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"description": "The name of the header."
},
"value": {
"type": "string",
"description": "The value of the header."
}
}
}
},
"originalTargetUrl": {
"$id": "#/properties/originalTargetUrl",
"type": "string",
"description": "The old URL to which MediaTailor was going to make a request."
},
"prefetchScheduleName": {
"$id": "#/properties/prefetchScheduleName",
"type": "string",
"description": "The name of the prefetch schedule associated with this ad event.",
"examples": [
"PrefetchScheduleName"
],
"pattern": "^(.*)$"
},
"updatedTargetUrl": {
"$id": "#/properties/updatedTargetUrl",
"type": "string",
"description": "The new URL to which MediaTailor is making a request."
},
"rawAdsResponse": {
"$id": "#/properties/rawAdsResponse",
"type": "string",
"description": "Paginated ADS response as it's exactly returned to MediaTailor."
},
"rawAdsResponseIndex": {
"$id": "#/properties/rawAdsResponseIndex",
"type": "integer",
"description": "Integer value denoting this rawAdsResponse's index into the full ADS response. This value is used to order the paginated messages for this ADS response."
}
},
"__COMMENT_oneOf": "The oneOf section defines subtypes for our events. Subtypes can have different rules, including which fields are required. For more information, see https://json-schema.org/understanding-json-schema/reference/combining.html#oneof ",
"oneOf": [
{ "$ref": "#/definitions/eventAdMarkersFound" },
{ "$ref": "#/definitions/eventNonAdMarkerFound" },
{ "$ref": "#/definitions/eventMakingAdsRequest" },
{ "$ref": "#/definitions/eventModifiedTargetUrl" },
{ "$ref": "#/definitions/eventRawAdsResponse" },
{ "$ref": "#/definitions/eventVastResponse" },
{ "$ref": "#/definitions/eventFilledAvail" },
{ "$ref": "#/definitions/eventFilledOverlayAvail" },
{ "$ref": "#/definitions/eventErrorFiringBeaconFailed" },
{ "$ref": "#/definitions/eventWarningNoAdvertisements" },
{ "$ref": "#/definitions/eventUnknownHost" },
{ "$ref": "#/definitions/eventErrorAdsTimeout" },
{ "$ref": "#/definitions/eventErrorVastMissingOverlays" },
{ "$ref": "#/definitions/eventPlannedAvail" },
{ "$ref": "#/definitions/eventEmptyVastResponse" },
{ "$ref": "#/definitions/eventEmptyVmapResponse" },
{ "$ref": "#/definitions/eventErrorUnknown" },
{ "$ref": "#/definitions/eventVastRedirect" },
{ "$ref": "#/definitions/eventRedirectedVastResponse" },
{ "$ref": "#/definitions/eventErrorAdsMissingImpression" },
{ "$ref": "#/definitions/eventErrorAdsResponseParse" },
{ "$ref": "#/definitions/eventErrorAdsInvalidResponse" },
{ "$ref": "#/definitions/eventErrorDisallowedHost"},
{ "$ref": "#/definitions/eventPersonalizationDisabled"},
{ "$ref": "#/definitions/eventWarningDynamicVariableSubFailed"},
{ "$ref": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset" },
{ "$ref": "#/definitions/eventVodTimeBasedAvailPlanSuccess" }
],
"definitions": {
"eventAdMarkersFound": {
"$id": "#/definitions/eventAdMarkersFound",
"required": [
"eventType",
"adMarkers"
],
"properties": {
"eventType": {
"type": "string",
"const": "AD_MARKER_FOUND"
}
}
},
"eventNonAdMarkerFound": {
"$id": "#/definitions/eventNonAdMarkerFound",
"required": [
"eventType",
"adMarkers"
],
"properties": {
"eventType": {
"type": "string",
"const": "NON_AD_MARKER_FOUND"
}
}
},
"eventMakingAdsRequest": {
"$id": "#/definitions/eventMakingAdsRequest",
"required": [
"eventType",
"adsRequestUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "MAKING_ADS_REQUEST"
}
}
},
"eventModifiedTargetUrl": {
"$id": "#/definitions/eventModifiedTargetUrl",
"required": [
"eventType",
"originalTargetUrl",
"updatedTargetUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "MODIFIED_TARGET_URL"
}
}
},
"eventRawAdsResponse": {
"$id": "#/definitions/eventRawAdsResponse",
"required": [
"eventType",
"rawAdsResponse",
"rawAdsResponseIndex"
],
"properties": {
"eventType": {
"type": "string",
"const": "RAW_ADS_RESPONSE"
}
}
},
"eventVastResponse": {
"$id": "#/definitions/eventVastResponse",
"_comment": "NOTE: the vastResponse property should ideally be marked as a required field for this event, but unfortunately, in the case of an empty vast response, we currently emit an EMPTY_VAST_RESPONSE followed by a VAST_RESPONSE, and the vastResponse property is not present in the latter. We need to fix this so that we don't emit both of those events in the empty response case, and update this schema to flag vastResponse as required for VAST_RESPONSE.",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "VAST_RESPONSE"
}
}
},
"eventFilledAvail": {
"$id": "#/definitions/eventFilledAvail",
"required": [
"eventType",
"avail"
],
"properties": {
"eventType": {
"type": "string",
"const": "FILLED_AVAIL"
}
}
},
"eventFilledOverlayAvail": {
"$id": "#/definitions/eventFilledOverlayAvail",
"required": [
"eventType",
"avail"
],
"properties": {
"eventType": {
"type": "string",
"const": "FILLED_OVERLAY_AVAIL"
}
}
},
"eventErrorVastMissingOverlays": {
"$id": "#/definitions/eventErrorVastMissingOverlays",
"required": [
"eventType",
"adsRequestUrl",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_VAST_MISSING_OVERLAYS"
}
}
},
"eventErrorFiringBeaconFailed": {
"$id": "#/definitions/eventErrorFiringBeaconFailed",
"required": [
"eventType",
"error",
"beaconInfo"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_FIRING_BEACON_FAILED"
}
}
},
"eventWarningNoAdvertisements": {
"$id": "#/definitions/eventWarningNoAdvertisements",
"required": [
"eventType"
],
"_comment": "We should really have a more descriptive error field for these events",
"properties": {
"eventType": {
"type": "string",
"const": "WARNING_NO_ADVERTISEMENTS"
}
}
},
"eventUnknownHost": {
"$id": "#/definitions/eventUnknownHost",
"required": [
"eventType",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_UNKNOWN_HOST"
}
}
},
"eventErrorAdsTimeout": {
"$id": "#/definitions/eventErrorAdsTimeout",
"required": [
"eventType",
"adsRequestUrl",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_TIMEOUT"
}
}
},
"eventPlannedAvail": {
"$id": "#/definitions/eventPlannedAvail",
"required": [
"eventType"
],
"_comment": "TODO: Flesh this out as we implement it",
"properties": {
"eventType": {
"type": "string",
"const": "PLANNED_AVAIL"
}
}
},
"eventEmptyVastResponse": {
"$id": "#/definitions/eventEmptyVastResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "EMPTY_VAST_RESPONSE"
}
}
},
"eventEmptyVmapResponse": {
"$id": "#/definitions/eventEmptyVmapResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "EMPTY_VMAP_RESPONSE"
}
}
},
"eventErrorUnknown": {
"$id": "#/definitions/eventErrorUnknown",
"required": [
"eventType"
],
"_comment": "TODO: we should have a field for the exception message or something",
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_UNKNOWN"
}
}
},
"eventVastRedirect": {
"$id": "#/definitions/eventVastRedirect",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "VAST_REDIRECT"
}
}
},
"eventRedirectedVastResponse": {
"$id": "#/definitions/eventRedirectedVastResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "REDIRECTED_VAST_RESPONSE"
}
},
"_comment": "NOTE that the property vastResponse is not required because empty vast responses do not contain a vastResponse."
},
"eventErrorAdsResponseParse": {
"$id": "#/definitions/eventErrorAdsResponseParse",
"required": [
"eventType"
],
"_comment": "We should have a field with an error message here",
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_RESPONSE_PARSE"
}
}
},
"eventErrorAdsInvalidResponse": {
"$id": "#/definitions/eventErrorAdsInvalidResponse",
"required": [
"eventType",
"additionalInfo"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_INVALID_RESPONSE"
}
}
},
"eventErrorAdsMissingImpression": {
"$id": "#/definitions/eventErrorAdsMissingImpression",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_VAST_MISSING_IMPRESSION"
}
}
},
"eventErrorDisallowedHost": {
"$id": "#/definitions/eventErrorDisallowedHost",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_DISALLOWED_HOST"
}
}
},
"eventPersonalizationDisabled": {
"$id": "#/definitions/eventPersonalizationDisabled",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_PERSONALIZATION_DISABLED"
}
}
},
"eventWarningDynamicVariableSubFailed": {
"$id": "#/definitions/eventWarningDynamicVariableSubFailed",
"required": [
"eventType",
"adsRequestUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "WARNING_URL_VARIABLE_SUBSTITUTION_FAILED"
}
}
},
"eventVodTimeBasedAvailPlanVastResponseForOffset": {
"$id": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset",
"required": [
"eventType",
"vastResponse"
],
"properties": {
"eventType": {
"type": "string",
"const": "VOD_TIME_BASED_AVAIL_PLAN_VAST_RESPONSE_FOR_OFFSET"
}
}
},
"eventVodTimeBasedAvailPlanSuccess": {
"$id": "#/definitions/eventVodTimeBasedAvailPlanSuccess",
"required": [
"eventType",
"vodCreativeOffsets"
],
"properties": {
"eventType": {
"type": "string",
"const": "VOD_TIME_BASED_AVAIL_PLAN_SUCCESS"
}
}
},
"creativeUniqueId": {
"type": "string",
"description": "The unique identifier for the ad, used as a key for transcoding. This is the ID field for the creative in the VAST response, if available. Otherwise, it's the mezzanine URL of the ad. "
},
"adSystem": {
"type": "string",
"description": "The value of the AdSystem tag in the VAST response. "
},
"vastDuration": {
"type": "number",
"description": "The duration of the ad, as parsed from the VAST response."
},
"transcodedAdDuration": {
"type": "number",
"description": "The duration of the ad, calculated from the transcoded asset."
},
"adContent": {
"$id": "#/properties/adContent",
"type": ["object", "null"],
"title": "adContent",
"description": "Information about the content of the inserted ad.",
"additionalProperties": false,
"properties": {
"adPlaylistUris": {
"$id": "#/properties/adContent/adPlaylistUris",
"type": "object",
"title": "adPlaylistUris",
"description": "The mapping from the origin manifest for a variant to the ad manifest for the variant. For DASH, this contains a single entry, because all variants are represented in a single DASH manifest. ",
"additionalProperties": {
"$id": "#/properties/adContent/adPlaylistUris/adPlaylistUri",
"type": "string",
"description": "The URL of the ad manifest for the specific variant."
}
}
}
},
"adMezzanineUri": {
"type": "string",
"description": "The URL of the mezzanine version of the ad, which is the input to the transcoder."
},
"bitrate": {
"type": "integer",
"examples": [
533
],
"description": "The bitrate."
},
"width": {
"type": "integer",
"examples": [
1280
],
"description": "Width in pixels."
},
"height": {
"type": "integer",
"examples": [
720
],
"description": "Height in pixels."
},
"trackingEvents": {
"type": "object",
"title": "trackingEvents",
"description": "The tracking beacon URLs for the various tracking events for the ad. The keys are the event names, and the values are a list of beacon URLs.",
"additionalProperties": {
"type": "array",
"description": "The list of beacon URLs for the specified tracking event (impression, complete, and so on)",
"items": {
"type": "string",
"description": "The beacon URLs for this tracking event."
}
}
},
"nonLinearAds": {
"$id": "#/properties/nonLinearAds",
"type": "object",
"title": "nonLinearAds",
"description": "A NonLinearAds as it appears in the VAST response.",
"required": [
"nonLinearAdList",
"nonLinearTrackingEvents"
],
"properties": {
"nonLinearAdList": {
"type": "array",
"description": "List of non linear ads as they exist within one NonLinearAds.",
"items": {
"type": "object",
"title": "nonLinearAdList",
"description": "List of NonLinearAd as they are parsed from its parent NonLinearAds.",
"properties": {
"nonLinearAdId": {
"type": "string",
"description": "Ad ID of this non linear ad."
},
"nonLinearAdSystem": {
"type": "string",
"description": "Ad system of this non linear ad's parent Inline ad."
},
"nonLinearAdTitle": {
"type": "string",
"description": "Ad title of this non linear ad's parent Inline ad."
},
"nonLinearCreativeId": {
"type": "string",
"description": "Creative ID of this non linear ad's parent Creative ad."
},
"nonLinearCreativeAdId": {
"type": "string",
"description": "Creative ad ID of this non linear ad."
},
"nonLinearCreativeSequence": {
"type": "string",
"description": "Creative sequence of this non linear ad."
},
"nonLinearWidth": {
"type": "string",
"description": "Width of this non linear ad."
},
"nonLinearHeight": {
"type": "string",
"description": "Height of this non linear ad."
},
"nonLinearExpandedWidth": {
"type": "string",
"description": "Expanded width of this non linear ad."
},
"nonLinearExpandedHeight": {
"type": "string",
"description": "Expanded height of this non linear ad."
},
"nonLinearScalable": {
"type": "boolean",
"description": "Boolean denoting if this non linear ad is scalable."
},
"nonLinearMaintainAspectRatio": {
"type": "boolean",
"description": "Boolean denoting if aspect ratio should be maintained for this non linear ad."
},
"nonLinearMinSuggestedDuration": {
"type": "string",
"description": "Min suggested duration for this non linear ad."
},
"nonLinearApiFramework": {
"type": "string",
"description": "API framework for this non linear ad's parent Inline ad."
},
"nonLinearStaticResource": {
"type": "string",
"description": "Static resource for this non linear ad."
},
"nonLinearStaticResourceCreativeType": {
"type": "string",
"description": "Static Resource creative type for this non linear ad."
},
"nonLinearIFrameResource": {
"type": "string",
"description": "I-Frame resource for this non linear ad."
},
"nonLinearHtmlResource": {
"type": "string",
"description": "HTML resource for this non linear ad."
},
"nonLinearAdParameters": {
"type": "string",
"description": "Ad parameters for this non linear ad."
},
"nonLinearClickThrough": {
"type": "string",
"description": "Click Through data for this non linear ad."
},
"nonLinearClickTracking": {
"type": "string",
"description": "Click Tracking data for this non linear ad."
},
"nonLinearClickTrackingId": {
"type": "string",
"description": "Click Tracking ID for this non linear ad."
}
}
}
},
"nonLinearTrackingEvents": { "$ref": "#/definitions/trackingEvents" },
"extensions": {
"$id": "#/properties/nonLinearAds/extensions",
"type": "array",
"description": "Extensions that exist for this NonLinearAds.",
"items": {
"$id": "#/properties/nonLinearAds/extensions/items",
"type": "object",
"title": "Extensions",
"description": "Extensions found in non linear ads",
"additionalProperties": false,
"properties": {
"extensionType": {
"$id": "#/properties/nonLinearAds/extensions/extensionType",
"type": "string",
"description": "The value of the extension type attribute of the Extensions tag.",
"examples": [
"FreeWheel"
]
},
"extensionContent": {
"$id": "#/properties/nonLinearAds/extensions/extensionContent",
"type": "string",
"description": "The extension content attribute of the Extensions tag.",
"examples": [
"progressive"
]
}
}
}
}
}
},
"adBreakTrackingEvents": {
"$id": "#/properites/adBreakTrackingEvents",
"type": "object",
"title": "adBreakTrackingEvents",
"description": "These are all VMAP ad break tracking events.",
"additionalProperties": {
"type": "array",
"description": "VMAP/ad break tracking events and corresponding URL",
"items": {
"type": "string",
"description": "The beacon URLs for this tracking event."
}
}
},
"vastAd": {
"$id": "#/properties/vastAd",
"type": "object",
"title": "vastAd",
"description": "Information about a single ad parsed from the VAST response.",
"required": [
"vastAdId",
"adSystem",
"adTitle",
"creativeId",
"creativeAdId",
"duration",
"vastMediaFiles",
"trackingEvents"
],
"additionalProperties": false,
"properties": {
"vastAdId": {
"$id": "#/properties/vastAd/vastAdId",
"type": "string",
"description": "The value of the id attribute of the Ad tag in the VAST response",
"examples": [
"ad1"
]
},
"adSystem": {"$ref": "#/definitions/adSystem" } ,
"adTitle": {
"$id": "#/properties/vastAd/adTitle",
"type": "string",
"description": "The media files that are available for the ad in the VAST response.",
"examples": [
"External NCA1C1L1 LinearInlineSkippable"
]
},
"creativeId": {
"$id": "#/properties/vastAd/creativeId",
"type": "string",
"description": "The value of the id attribute of the Creative tag in the VAST response.",
"examples": [
"creative1"
]
},
"creativeAdId": {
"$id": "#/properties/vastAd/creativeAdId",
"type": "string",
"description": "The value of the adId attribute of the Creative tag in the VAST response."
},
"duration": {
"$id": "#/properties/vastAd/duration",
"type": "number",
"description": "The approximate duration of the ad, based on the duration tag in the linear element of the VAST response.",
"examples": [
30,
30.0
]
},
"vastMediaFiles": {
"$id": "#/properties/vastAd/vastMediaFiles",
"type": "array",
"description": "The list of available media files for the ad in the VAST response.",
"items": {
"$id": "#/properties/vastAd/vastMediaFiles/items",
"type": "object",
"title": "vastMediaFile",
"description": "Information about a media file for the ad.",
"required": [
"uri",
"id",
"delivery",
"type",
"apiFramework",
"width",
"height",
"bitrate"
],
"additionalProperties": false,
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"id": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/id",
"type": "string",
"description": "The value of the id attribute of the MediaFile tag.",
"examples": [
"GDFP"
]
},
"delivery": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/delivery",
"type": "string",
"description": "The protocol used for the media file, set to either progressive or streaming.",
"examples": [
"progressive"
]
},
"type": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/type",
"type": "string",
"description": "The MIME type of the media file, taken from the type attribute of the MediaFile tag.",
"examples": [
"video/mp4"
]
},
"apiFramework": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/apiFramework",
"type": "string",
"description": "The API framework needed to manage the media file. Example: VPAID."
},
"width": {
"$ref": "#/definitions/width"
},
"height": {
"$ref": "#/definitions/height"
},
"bitrate": {
"$ref": "#/definitions/bitrate"
}
}
}
},
"trackingEvents": { "$ref": "#/definitions/trackingEvents" },
"vastAdTagUri": {
"$id": "#/properties/vastAd/vastAdTagUri",
"type": "string",
"description": "The VMAP-specific redirect URI for an ad.",
"examples": [
"https://ads.redirect.com/redirect1"
]
}
}
}
}
}
```
# AWS Elemental MediaTailor Beschreibung und Ereignistypen der Manifestprotokolle
In den folgenden Abschnitten werden die Protokolle beschrieben, die ausgegeben MediaTailor werden, um Ereignisse mit dem Ursprungsserver zu beschreiben, wenn ein Manifest angefordert und empfangen wird. Dies sind `ManifestService` Protokolle.
**Topics**
+ [ManifestService-Ereignisse](#log-types-origininteraction)
+ [Das Manifest protokolliert die Eigenschaften](#manifest-logs-main)
## ManifestService-Ereignisse
Die folgenden Ereignisse werden bei MediaTailor Interaktionen mit dem Ursprung ausgelöst.
| Protokoll | Description |
| --- | --- |
| CONFIG\$1SECURITY\$1ERROR | Die MediaTailor Konfiguration hat ein Sicherheitsproblem. |
| CONFIG\$1SYNTAX\$1ERROR | Der Ursprung und der Asset-Pfad führen zu einer falsch formatierten URL. |
| CONNECTION\$1ERROR | Die MediaTailor Verbindung zum Ursprung wurde abgelehnt oder ist fehlgeschlagen. |
| GENERATED\$1MANIFEST | MediaTailor hat ein Manifest generiert. Sie müssen den Debug-Modus aktiviert haben, um diese Protokolle empfangen zu können. Hinweise zum Debug-Protokollmodus, einschließlich seiner Aktivierung, finden Sie unter. [Debug-Protokolle generieren](debug-log-mode.md) |
| HOST\$1DISALLOWED | MediaTailor lässt keine HTTP-Anfragen an diesen Host zu. |
| INCOMPATIBLE\$1HLS\$1VERSION | Das Manifest verwendet eine inkompatible HLS-Version. MediaTailor erfordert Version 3 oder höher. |
| INVALID\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Das DASH-Manifest mit einer Periode ist ungültig. MediaTailor durchläuft ein DASH-Manifest mit einer einzigen Periode. |
| IO\$1ERROR | MediaTailor ist bei der Kommunikation mit dem Ursprung auf einen IO-Fehler gestoßen. |
| LAST\$1PERIOD\$1MISSING\$1AUDIO | Im letzten Abschnitt des DASH-Manifests fehlt der gesamte Ton AdaptationSets aufgrund einer falschen Ausrichtung der ursprünglichen Audio- oder Videodaten. Um Probleme bei der Wiedergabe zu vermeiden, sollten Sie die Veröffentlichung des letzten Zeitraums bis mindestens zur nächsten Anfrage verschieben. |
| LAST\$1PERIOD\$1MISSING\$1AUDIO\$1WARNING | Im letzten Abschnitt des DASH-Manifests fehlt AdaptationSets aufgrund einer falschen Ausrichtung der ursprünglichen Audio- oder Videodaten das gesamte Audio. Es wird entschieden, den letzten Zeitraum zu veröffentlichen (nicht zu verzögern). Fehlendes Audio kann zu Problemen bei der Wiedergabe führen. |
| MANIFEST\$1ERROR | Die MediaTailor Manifestanforderung ist fehlgeschlagen. |
| NO\$1MASTER\$1OR\$1MEDIA\$1PLAYLIST | Die ursprüngliche Antwort enthält keine primäre Playlist oder Medien-Playlist. |
| NO\$1MASTER\$1PLAYLIST | Die ursprüngliche Antwort enthält nicht die erwartete primäre Playlist. |
| NO\$1MEDIA\$1PLAYLIST | Die ursprüngliche Antwort enthält nicht die erwartete Medien-Playlist. |
| ORIGIN\$1MANIFEST | MediaTailor hat ein Ursprungsmanifest abgerufen. Sie müssen den Debug-Modus aktiviert haben, um diese Protokolle empfangen zu können. Hinweise zum Debug-Protokollmodus, einschließlich seiner Aktivierung, finden Sie unter. [Debug-Protokolle generieren](debug-log-mode.md) |
| PARSING\$1ERROR | Der Ursprung kann die Manifestanforderung nicht analysieren. |
| SCTE35\$1PARSING\$1ERROR | MediaTailor kann das Signal Binary Element im Manifest nicht analysieren. |
| SESSION\$1INITIALIZED | Eine Sitzung wurde initialisiert. Sie müssen den Debug-Modus aktiviert haben, um diese Protokolle empfangen zu können. Hinweise zum Debug-Protokollmodus, einschließlich seiner Aktivierung, finden Sie unter. [Debug-Protokolle generieren](debug-log-mode.md) |
| TIMEOUT\$1ERROR | Bei der MediaTailor Manifestanforderung wurde das Zeitlimit überschritten. |
| TRACKING\$1RESPONSE | MediaTailor hat eine Tracking-Antwort zugestellt. Sie müssen den Debug-Modus aktiviert haben, um diese Protokolle empfangen zu können. Hinweise zum Debug-Protokollmodus, einschließlich seiner Aktivierung, finden Sie unter. [Debug-Protokolle generieren](debug-log-mode.md) |
| UNKNOWN\$1ERROR | MediaTailor ist auf einen unbekannten Fehler gestoßen. |
| UNKNOWN\$1HOST | Der Host ist unbekannt. |
| UNSUPPORTED\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Das DASH-Manifest mit einer Periode wird nicht unterstützt. MediaTailor durchläuft ein DASH-Manifest mit einer einzigen Periode. |
## Das Manifest protokolliert die Eigenschaften
In diesem Abschnitt werden die Eigenschaften der Manifestprotokolle beschrieben.
| Eigenschaft | Typ | Erforderlich |
| --- | --- | --- |
| awsAccountId | Zeichenfolge | true |
| eventTimestamp | Zeichenfolge | true |
| originId | Zeichenfolge | true |
| customerId | Zeichenfolge | false |
| eventType | Zeichenfolge | false |
| sessionId | Zeichenfolge | false |
| originRequestUrl | Zeichenfolge | false |
| mediaTailorPath | Zeichenfolge | false |
| requestId | Zeichenfolge | false |
| responseBody | Zeichenfolge | false |
| sessionType | Zeichenfolge (zulässige Werte: [DASH, HLS]) | false |
| requestNextToken | Zeichenfolge | false |
| eventDescription | Zeichenfolge | false |
| assetPath | Zeichenfolge | false |
| originFullUrl | Zeichenfolge | false |
| originPrefixUrl | Zeichenfolge | false |
| additionalInfo | Zeichenfolge | false |
| cause | Zeichenfolge | false |
| response | Zeichenfolge | false |
| httpCode | Zeichenfolge | false |
| errorMessage | Zeichenfolge | false |
| adAdsResponse | Zeichenfolge | false |
| adAdsRawResponse | Zeichenfolge | false |
| adAdsRequest | Zeichenfolge | false |
| adNumNewAvails | Zeichenfolge | false |
| generatedMediaPlaylist | Zeichenfolge | false |
| requestStartTime | Zeichenfolge | false |
| requestEndTime | Zeichenfolge | false |
| requestStartTimeEpochMillis | Zeichenfolge | false |
| requestEndTimeEpochMillis | Zeichenfolge | false |
# AWS Elemental MediaTailor Beschreibung und Ereignistypen der Transcodierungsprotokolle
In den folgenden Abschnitten werden die Logs beschrieben, die ausgegeben werden MediaTailor , um Ereignisse mit dem Transcode-Dienst zu beschreiben, wenn Werbematerial auf das Anzeigen-Stitching vorbereitet wird. Dabei handelt es sich um Protokolle. `TranscodeService`
**Topics**
+ [TranscodeService-Ereignisse](#log-types-tminteraction)
+ [Eigenschaften von Transcode-Protokollen](#transcode-logs-main)
## TranscodeService-Ereignisse
Die folgenden Ereignisse werden bei MediaTailor Interaktionen während der Transcodierung von Anzeigen ausgelöst.
| Protokoll | Description |
| --- | --- |
| IMPORT\$1ERROR | MediaTailor ist während eines Importauftrags (für vorkonditionierte Werbung) auf einen internen Fehler gestoßen. Es wurde ein leerer Satz von Anzeigen verwendet. |
| INITIALIZED | MediaTailor hat entweder einen Transcodierungsauftrag oder einen Importauftrag (für vorkonditionierte Anzeigen) initialisiert. |
| INTERNAL\$1ERROR | MediaTailor ist auf einen internen Fehler gestoßen. Es wurde ein leerer Satz von Anzeigen verwendet. |
| MISSING\$1VARIANTS | MediaTailor konnte die Anzeige aufgrund fehlender Varianten nicht transkodieren. Es wurde ein leerer Satz von Anzeigen verwendet. |
| PROFILE\$1NOT\$1FOUND | MediaTailor konnte die Anzeige nicht transkodieren, da ein zu transkodierendes Profil fehlt. Es wurde ein leerer Satz von Anzeigen verwendet. |
| TRANSCODE\$1COMPLETED | Die Videotranskodierung ist abgeschlossen. Die Anzeige kann zum Einfügen von Anzeigen verwendet werden. |
| TRANSCODE\$1ERROR | MediaTailor ist während eines Transcodierungsauftrags auf einen internen Fehler gestoßen. Es wurde ein leerer Satz von Anzeigen verwendet. |
| TRANSCODE\$1IN\$1PROGRESS | Die Videotranskodierung ist im Gange. Das transkodierte Video ist nicht bereit. Es wird ein leerer Satz von Anzeigen verwendet. |
## Eigenschaften von Transcode-Protokollen
In diesem Abschnitt werden die Eigenschaften der Transcodierungsprotokolle beschrieben.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| awsAccountId | Zeichenfolge | true | Die AWS Konto-ID für die MediaTailor Konfiguration, die für die Sitzung verwendet wurde. |
| eventTimestamp | Zeichenfolge | true | Das Datum und die Uhrzeit des Ereignisses. |
| originId | Zeichenfolge | true | Der Konfigurationsname aus der MediaTailor Konfiguration. Dies unterscheidet sich von der Quelle der Videoinhalte, die ebenfalls Teil der Konfiguration ist. |
| eventType | Zeichenfolge | false | Der Code für das Ereignis, das diese Protokollnachricht ausgelöst hat. Beispiel: TRANSCODE\$1ERROR. |
| eventDescription | Zeichenfolge | false | Eine kurze Beschreibung des Ereignisses, das diese Protokollnachricht ausgelöst hat. Sie wird vom MediaTailor Dienst bereitgestellt. Standardmäßig ist dieses Feld leer. |
| sessionId | Zeichenfolge | false | Die eindeutige numerische Kennung, die MediaTailor der Spielersitzung zugewiesen wurde. Alle Anforderungen, die ein Spieler für eine Sitzung stellt, haben dieselbe Sitzungs-ID. Beispiel: e039fd39-09f0-46b2-aca9-9871cc116cde. |
| creativeUniqueId | Zeichenfolge | false | Die eindeutige Kennung für das Werbematerial, das transkodiert wird. |
| profileName | Zeichenfolge | false | |
| adUri | Zeichenfolge | false | Die URI für das Werbemittel. |
| transcodeRequestId | Zeichenfolge | false | Die eindeutige Kennung für diese Transcodierungsanforderung. |
| cacheStatus | Zeichenfolge | false | Gibt an, ob die MediaTailor transkodierte Anzeige zwischengespeichert wurde. |
# Versendete Protokolle werden zum Senden von Protokollen verwendet AWS Elemental MediaTailor
Sie können Vended-Logs verwenden, um flexibler zu MediaTailor sein und mehr Kontrolle darüber zu haben, wohin Logs aus Ihrer Wiedergabekonfiguration gesendet werden sollen.
MediaTailor Sendet bei verkauften Protokollen alle Protokollaktivitäten, die mit einer Konfiguration verknüpft sind, an Amazon CloudWatch Logs. CloudWatch Logs sendet dann den Prozentsatz der von Ihnen angegebenen Logs an das von Ihnen gewählte Ziel. Unterstützte Ziele sind eine Amazon CloudWatch Logs-Protokollgruppe, ein Amazon S3 S3-Bucket oder ein Amazon Data Firehose-Stream.
Da verkaufte Protokolle zu Mengenrabatten erhältlich sind, können Sie im Vergleich zum direkten Senden von Protokollen an Logs Kosteneinsparungen feststellen. CloudWatch Die Preise finden Sie unter *Verkaufte Logs* auf der Registerkarte **Logs** bei [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/).
Um Vended Logs zu verwenden, müssen Sie wie folgt vorgehen:
1. [Berechtigungen hinzufügen](#vended-logs-perms).
1. [Erstellen Sie Ziele für die Protokollzustellung](#vended-logs-destinations).
1. [Konfigurieren Sie die Protokollzustellung in CloudWatch Logs](#vended-logs-delivery).
1. [Aktivieren Sie Vended-Logs in MediaTailor](#vended-logs-config).
Weitere Informationen zu Vended-Logs finden Sie unter [Aktivieren der Protokollierung von AWS Diensten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) im CloudWatch Logs-Benutzerhandbuch. MediaTailor unterstützt Version 2 der verkauften Logs.
## Schritt 1: Fügen Sie Berechtigungen für die MediaTailor Protokollzustellung hinzu
Die Person, die Versandprotokolle einrichtet, muss über die erforderlichen Berechtigungen verfügen, um das Zustellungsziel zu erstellen, die Protokollzustellung zu konfigurieren und die Anmeldung per Versand zu aktivieren. MediaTailor Verwenden Sie die folgenden Richtlinien, um sicherzustellen, dass Sie über die entsprechenden Berechtigungen zum Einrichten von Versandprotokollen verfügen.
**Richtlinien für CloudWatch Protokolle und Lieferziele**
Die folgenden Abschnitte im *Amazon CloudWatch Logs-Benutzerhandbuch* enthalten die Richtlinien, die es Ihnen ermöglichen, mit Protokollen in CloudWatch Logs und Ihren Lieferzielen zu arbeiten. Wenn Sie Protokolle an mehrere Standorte senden, können Sie die Richtlinienerklärungen zu einer Richtlinie zusammenfassen, anstatt mehrere Richtlinien zu erstellen.
+ [Protokolle, die an CloudWatch Logs gesendet wurden](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs)
+ [An Amazon S3 gesendete Protokolle](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-S3)
+ [An Firehose gesendete Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-Firehose)
**Richtlinie für die Einrichtung über die Konsole**
Wenn Sie den Versand von Verkaufsprotokollen über die Konsole statt über die API oder einrichten AWS CLI, müssen Sie in Ihrer Richtlinie über die folgenden zusätzlichen Berechtigungen verfügen.
**Die Richtlinie für verkaufte Logins MediaTailor**
In Ihrer Richtlinie müssen Sie über die folgenden Berechtigungen verfügen, um die Zustellung von ausgelieferten Protokollen zu erstellen MediaTailor, anzuzeigen oder zu ändern.
Informationen zum Hinzufügen von Berechtigungen und zum Arbeiten mit Richtlinien finden Sie unter[Identity and Access Management für AWS Elemental MediaTailor](security-iam.md).
## Schritt 2: Lieferziele für MediaTailor Protokolle erstellen
Erstellen Sie die Ressourcen, an die Ihre Protokolle gesendet werden sollen. Notieren Sie den ARN der Ressource, um ihn bei der Konfiguration der Protokollzustellung in einem späteren Schritt zu verwenden.
**CloudWatch Protokolliert das Ziel der Protokollgruppenzustellung**
Verwenden Sie eine der folgenden Optionen, um Hilfe bei der Erstellung einer Protokollgruppe zu erhalten.
+ Informationen zur Konsole finden Sie unter [Erstellen einer Protokollgruppe in CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) im *Amazon CloudWatch Logs-Benutzerhandbuch*.
+ Informationen zur API finden Sie [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)in der *Amazon CloudWatch Logs API-Referenz.*
+ Informationen zu SDKs und CLI finden [Sie unter Verwendung `CreateLogGroup` mit einem AWS SDK oder AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.
**Lieferziel für Amazon S3 S3-Buckets**
Verwenden Sie eine der folgenden Optionen, um Hilfe bei der Erstellung eines Buckets zu erhalten.
+ Informationen zur Konsole und zur CLI finden Sie unter [Create a Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) im *Amazon Simple Storage Service-Benutzerhandbuch*. SDKs
+ Informationen zur API finden Sie [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)in der *Amazon Simple Storage Service API-Referenz*.
**Firehose Stream-Lieferziel**
Hilfe beim Erstellen eines Streams finden Sie unter [Create a Firehose Stream from console](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) im *Amazon Data Firehose Developer Guide*.
## Schritt 3: Aktivieren Sie Vended-Logs für die Wiedergabekonfiguration MediaTailor
Erstellen oder aktualisieren Sie die Wiedergabekonfiguration, mit der Protokolle an das Lieferziel gesendet werden, das Sie im vorherigen Schritt erstellt haben. Notieren Sie sich den Namen der Konfiguration, um ihn bei der Konfiguration der Protokollzustellung in einem späteren Schritt zu verwenden.
+ Um die Übertragung von Protokollen über die Konsole zu aktivieren, verwenden [Konfiguration erstellen](configurations-create.md) oder [Konfigurationseinstellungen bearbeiten](configurations-edit.md) bearbeiten Sie eine Konfiguration, um auf die **Protokollierungseinstellungen** zuzugreifen. Wählen **Sie für Logging-Strategien** die Option **Vended** Logs aus.
+ Um Vended Logs über die API zu aktivieren, müssen Sie über eine bestehende Konfiguration verfügen. Wird verwendet`ConfigureLogsForPlaybackConfiguration`, um die Protokollierungsstrategie `Vended logs` hinzuzufügen.
Wenn Sie die bisherige MediaTailor Protokollierungsstrategie verwenden, bei der Logs direkt an Logs gesendet werden, und zu ausverkauften CloudWatch Logs migrieren möchten, finden Sie weitere Informationen unter[Migration der Protokollierungsstrategie](vended-logs-migrate.md).
**Wichtig**
Wenn Sie die Protokollstrategie von Legacy CloudWatch auf Vended Logs ändern, MediaTailor wird diese Änderung vorgenommen, sobald Sie die Aktualisierungen speichern. Sie erhalten keine Logs mehr, bis Sie die vollständige Konfiguration von Vended Logging abgeschlossen haben.
## Schritt 4: Konfigurieren Sie die Protokollzustellung in CloudWatch Logs
In CloudWatch Logs müssen Sie drei Elemente erstellen, die die einzelnen Teile der Protokollzustellung darstellen. Diese Elemente werden in der *Amazon CloudWatch Logs API-Referenz* ausführlich beschrieben. [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html) Die allgemeinen Schritte zur Konfiguration der Lieferung mit der CloudWatch Logs-API lauten wie folgt.
**So konfigurieren Sie die Protokollzustellung in CloudWatch Logs (API)**
1. Wird verwendet [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html), um die Quelle der Protokolle hinzuzufügen.
A `DeliverySource` steht für die Wiedergabekonfiguration, die die Protokolle generiert. Sie benötigen den Namen der Wiedergabekonfiguration, um die zu erstellen`DeliverySource`.
1. Wird verwendet [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html), um das Ziel hinzuzufügen, in das die Protokolle geschrieben werden.
A `DeliveryDestination` steht für das Lieferziel. Sie benötigen den ARN der Protokollgruppe, des Buckets oder des Streams, um den zu erstellen`DeliveryDestination`.
1. Verwenden Sie [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)diese Option, wenn Sie Logs kontenübergreifend bereitstellen.
Wenn sich das Lieferziel in einem anderen Konto als in der Wiedergabekonfiguration befindet, benötigen Sie ein`DeliveryDestinationPolicy`. Diese Richtlinie ermöglicht CloudWatch Logs die Übermittlung von Protokollen an die`DeliveryDestination`.
1. Wird verwendet [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html), um das `DeliverySource` mit dem zu verknüpfen`DeliveryDestination`.
A `Delivery` steht für die Verbindung zwischen `DeliverySource` und`DeliveryDestination`.
# Migrieren Sie Ihre AWS Elemental MediaTailor Protokollierungsstrategie
Wenn Sie die Protokollstrategie von Legacy CloudWatch auf Vended Logs ändern, MediaTailor wird diese Änderung vorgenommen, sobald Sie die Updates speichern. Gehen Sie wie folgt vor, um Unterbrechungen in Ihrem Logging-Workflow zu vermeiden, um Ihre Protokollierungsstrategie zu migrieren.
1. Führen Sie die unter [Verwendung von verkauften Protokollen](vended-logs.md) beschriebenen Schritt aus. Wählen Sie für [Aktivieren Sie Vended-Logs in MediaTailor](vended-logs.md#vended-logs-config) *beide* Protokollierungsstrategien (**Vending Logs und** **Legacy CloudWatch**) aus.
MediaTailor sendet Protokolle sowohl über verkaufte Logs als auch direkt an CloudWatch Logs.
1. Nehmen Sie die erforderlichen Änderungen in Ihrem Arbeitsablauf vor, die von Ihrer Protokollierungsstrategie und Ihrem Lieferziel abhängen.
1. Besuchen Sie **Legacy** erneut [Aktivieren Sie Vended-Logs in MediaTailor](vended-logs.md#vended-logs-config) und entfernen Sie es CloudWatch aus den **Protokollierungsstrategien**.
# AWS Elemental MediaTailor Logs direkt in Amazon CloudWatch Logs schreiben
MediaTailor erstellt Protokolle, die detaillierte Informationen über Sitzungsaktivitäten und Interaktionen mit dem Anzeigenentscheidungsserver enthalten, und schreibt sie an Amazon CloudWatch. Die Protokolle enthalten eine sequentielle Beschreibung der Aktivitäten, die während der Sitzung stattfinden.
MediaTailor kann auch verkaufte Holzscheite verwenden, um Flexibilität bei der Holzlieferung und Mengenrabatte zu erzielen. Informationen zu verkauften Protokollen finden Sie unter. [Verwendung von verkauften Protokollen](vended-logs.md)
**Topics**
+ [Berechtigungen für Amazon CloudWatch Logs](monitoring-permissions.md)
+ [Protokoll „As Run“ für AWS Elemental MediaTailor Channel Assembly](as-run-log.md)
+ [AWS Elemental MediaTailor ADS-Protokollanalyse in Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)
# Berechtigungen für Amazon CloudWatch Logs
Verwenden Sie AWS Identity and Access Management (IAM), um eine Rolle zu erstellen, die AWS Elemental MediaTailor Zugriff auf Amazon CloudWatch gewährt. Sie müssen diese Schritte ausführen, damit CloudWatch Logs für Ihr Konto veröffentlicht werden. CloudWatch veröffentlicht automatisch Metriken für Ihr Konto.
**Um den MediaTailor Zugriff zu ermöglichen CloudWatch**
1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.
1. Klicken Sie im Navigationsbereich der IAM-Konsole auf **Rollen**, und wählen Sie dann **Rolle erstellen**.
1. Wählen Sie den Rollentyp „**Anderes AWS Konto**“.
1. Geben Sie als **Konto-ID** Ihre AWS Konto-ID ein.
1. Wählen Sie **Require external ID (Externe ID fordern)** und geben Sie **Midas** ein. Mit dieser Option wird automatisch eine Bedingung zur Vertrauensrichtlinie hinzugefügt, die es dem Service nur dann ermöglicht, die Rolle anzunehmen, wenn in der Anforderung die richtige `sts:ExternalId` enthalten ist.
1. Wählen Sie **Weiter: Berechtigungen** aus.
1. Fügen Sie eine Berechtigungsrichtlinie hinzu, in der die Aktionen angegeben werden, die von dieser Rolle ausgeführt werden dürfen. Wählen Sie eine der folgenden Optionen aus und wählen Sie dann **Next: Review (Nächster Schritt: Prüfen)**:
+ **CloudWatchLogsFullAccess**um vollen Zugriff auf Amazon CloudWatch Logs zu gewähren
+ **CloudWatchFullAccess**um vollen Zugriff auf Amazon zu gewähren CloudWatch
1. Geben Sie für **Role name (Rollenname)** den Namen **MediaTailorLogger** ein und klicken Sie auf **Create role (Rolle erstellen)**.
1. Wählen Sie auf der Seite **Roles (Rollen)** die von Ihnen soeben erstellte Rolle aus.
1. Bearbeiten Sie die Vertrauensstellung, um den Prinzipal zu aktualisieren:
1. Wählen Sie auf der Seite **Summary (Übersicht)** der Rolle die Registerkarte **Trust relationship (Vertrauensstellung)** aus.
1. Wählen Sie **Vertrauensstellung bearbeiten** aus.
1. Ändern Sie im Richtliniendokument den Principal in den MediaTailor Service. Das sollte wie folgt aussehen:
```
"Principal": {
"Service": "mediatailor.amazonaws.com"
},
```
Die gesamte Richtlinie sollte folgendermaßen lauten:
1. Wählen Sie **Update Trust Policy** (Trust Policy aktualisieren).
# Protokoll „As Run“ für AWS Elemental MediaTailor Channel Assembly
Das *As Run-Protokoll* in der CloudWatch `MediaTailor/Channel/AsRunLog` Protokollgruppe enthält Informationen zu Programmen und Werbeunterbrechungen, während sie abgespielt werden.
Wenn Sie einen Channel erstellen, ist das As Run-Protokoll standardmäßig deaktiviert. Mit der Konsole oder der AWS Command Line Interface (AWS CLI) können Sie den Protokollstatus „As Run“ für jeden Kanal in Ihrem Konto aktivieren und deaktivieren.
Wenn Sie das As-Run-Protokoll aktivieren, MediaTailor wird automatisch eine dienstbezogene Rolle erstellt, mit der Sie das As-Run-Protokoll in Ihrem CloudWatch Logs-Konto schreiben und verwalten können MediaTailor . Weitere Informationen zu serviceverknüpften Rollen finden Sie unter [Verwenden von serviceverknüpften Rollen für MediaTailor](using-service-linked-roles.md).
**Anmerkung**
Das As Run Log unterstützt derzeit nur das Standardprogramm. Derzeit werden die durch Programmregeln erstellten AlternateMedia nicht unterstützt. Dies bedeutet, dass das As Run Log für AlternateMedia derzeit nicht generiert wird.
**Topics**
+ [Das As Run-Protokoll aktivieren](enabling-as-run-log.md)
+ [Das As Run-Protokoll deaktivieren](disabling-as-run-log.md)
# Das As Run-Protokoll aktivieren
Um das As Run-Protokoll zu aktivieren, geben Sie den Kanalnamen an und aktivieren Sie den Protokolltyp *As Run* für diesen Kanal.
------
#### [ Console ]
**Um das As Run-Protokoll beim Erstellen eines Kanals zu aktivieren**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie in der Navigationsleiste die Option **Kanal erstellen** aus.
1. Konfigurieren Sie Ihren **Kanal in den Bereichen Kanaldetails festlegen**, **Ausgänge konfigurieren** und **Zugriffskontrolle** wie gewünscht.
1. Wählen Sie im Bereich **Zugriffskontrolle** die Option **Weiter** aus.
1. Wählen Sie im Bereich **Protokollierung** unter **Protokolltypen** die Option **Als Ausführung aktivieren** aus, um das Protokoll Als Ausführung zu aktivieren.
**Um das As-Run-Protokoll bei der Aktualisierung eines Kanals zu aktivieren**
**Anmerkung**
Wenn der Kanal gerade läuft, müssen Sie ihn zuerst beenden, bevor Sie ihn aktualisieren können. Nachdem Sie den Kanal gestoppt haben, können Sie „**Aktionen****“ > „Bearbeiten“** wählen, um mit der Aktualisierung des Kanals zu beginnen.
1. Melde dich bei an AWS-Managementkonsole und öffne die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll aktualisieren möchten.
1. Wählen Sie **Actions** (Aktionen) und **Edit** (Bearbeiten).
1. Aktualisieren Sie in den **Bereichen Kanaldetails festlegen**, **Ausgänge konfigurieren** und **Zugriffskontrolle** Ihre Kanalkonfiguration wie gewünscht.
1. Wählen Sie im Bereich „**Zugriffskontrolle**“ die Option **Weiter** aus.
1. Wählen Sie im Bereich **Protokollierung** unter **Protokolltypen** die Option **Als Ausführung aktivieren** aus, um das Protokoll Als Ausführung zu aktivieren.
**Um das As-Run-Protokoll auf der Registerkarte **Protokollierung** zu aktivieren**
**Anmerkung**
Wenn der Channel gerade läuft, müssen Sie die Registerkarte **Logging** verwenden, anstatt **Aktionen** > **Bearbeiten** zu wählen, um das As Run-Protokoll zu aktivieren.
1. Melden Sie sich bei an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll aktivieren möchten.
1. Wählen Sie in der Navigationsleiste unter dem Namen des Kanals die Option **Logging** aus.
1. Wählen Sie unter **Protokollierung** > **Protokolltypen** die Option **Als ausgeführt** aus, um das Protokoll Als ausgeführt zu aktivieren.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Um das As Run-Protokoll zu aktivieren**
Führen Sie den [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)Befehl aus und geben Sie die entsprechenden Werte für die erforderlichen Parameter an.
Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\$1) zur Verbesserung der Lesbarkeit.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types AS_RUN
```
Dieses Beispiel ist für Microsoft Windows formatiert und verwendet das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types AS_RUN
```
Wobei Folgendes gilt:
+ `MyChannel`ist der Name des Kanals, der Ihnen gehört und für den Sie das As Run-Protokoll aktivieren möchten.
Wird der Befehl erfolgreich ausgeführt, erhalten Sie eine Ausgabe ähnlich der folgenden:
```
{
"ChannelName": "MyChannel",
"LogTypes": [
"AS_RUN"
]
}
```
------
# Das As Run-Protokoll deaktivieren
Um das As-Run-Protokoll für einen Kanal zu deaktivieren, für den es aktiviert ist, geben Sie den Kanalnamen an und deaktivieren Sie den Protokolltyp *As Run* für diesen Kanal.
------
#### [ Console ]
**Um das As Run-Protokoll bei der Aktualisierung eines Kanals zu deaktivieren**
**Anmerkung**
Wenn der Kanal gerade läuft, müssen Sie ihn zuerst beenden, bevor Sie ihn aktualisieren können. Nachdem Sie den Kanal gestoppt haben, können Sie „**Aktionen****“ > „Bearbeiten“** wählen, um mit der Aktualisierung des Kanals zu beginnen.
1. Melde dich bei an AWS-Managementkonsole und öffne die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll aktualisieren möchten.
1. Wählen Sie **Actions** (Aktionen) und **Edit** (Bearbeiten).
1. Aktualisieren Sie in den **Bereichen Kanaldetails festlegen**, **Ausgänge konfigurieren** und **Zugriffskontrolle** Ihre Kanalkonfiguration wie gewünscht.
1. Wählen Sie im Bereich „**Zugriffskontrolle**“ die Option **Weiter** aus.
1. Deaktivieren Sie im Bereich **Protokollierung** unter **Protokolltypen** die Option **Als Ausführung aktivieren**, um das Protokoll Als Ausführung zu deaktivieren.
**Um das As-Run-Protokoll auf der Registerkarte **Protokollierung** zu deaktivieren**
**Anmerkung**
Wenn der Channel gerade läuft, müssen Sie die Registerkarte **Logging** verwenden, anstatt **Aktionen** > **Bearbeiten** zu wählen, um das As Run-Protokoll zu deaktivieren.
1. Melden Sie sich bei an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll deaktivieren möchten.
1. Wählen Sie in der Navigationsleiste unter dem Namen des Kanals die Option **Logging** aus.
1. Deaktivieren Sie unter **Protokollierung** > **Protokolltypen** die Option **Als ausgeführt**, um das Protokoll Als ausgeführt zu deaktivieren.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Um das As-Run-Protokoll zu deaktivieren**
Führen Sie den [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)Befehl aus und geben Sie die entsprechenden Werte für die erforderlichen Parameter an.
Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\$1) zur Verbesserung der Lesbarkeit.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types
```
Dieses Beispiel ist für Microsoft Windows formatiert und verwendet das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types
```
Wobei Folgendes gilt:
+ `MyChannel`ist der Name des Kanals, dessen Eigentümer Sie sind und für den Sie das As Run-Protokoll deaktivieren möchten.
Wird der Befehl erfolgreich ausgeführt, erhalten Sie eine Ausgabe ähnlich der folgenden:
```
{
"ChannelName": "MyChannel",
"LogTypes": []
}
```
------
# AWS Elemental MediaTailor ADS-Protokollanalyse in Amazon CloudWatch Logs Insights
Mit Amazon CloudWatch Logs Insights können Sie AWS Elemental MediaTailor ADS-Protokolle (Ad Decision Server) anzeigen und abfragen. MediaTailor sendet Ereignisprotokolle CloudWatch für normale Verarbeitungs- und Fehlerbedingungen an. Die Protokolle entsprechen einem JSON-Schema. Mit CloudWatch Logs Insights können Sie Protokolle nach Zeitrahmen auswählen und dann Abfragen für sie ausführen.
Allgemeine Informationen finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html).
**Anmerkung**
Um auf die Protokolle zugreifen zu können, benötigen Sie Berechtigungen für den Zugriff auf Amazon CloudWatch. Detaillierte Anweisungen finden Sie unter [Berechtigungen für Amazon CloudWatch Logs](monitoring-permissions.md).
**Um ADS-Protokolle über die CloudWatch Konsole anzuzeigen und abzufragen**
1. Öffnen Sie die CloudWatch Konsole unter[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im Navigationsbereich unter **Logs**, (Protokolle) die Option **Insights**(Einblicke) aus.
1. Geben Sie in der Suchleiste ein**AdDec**, und wählen Sie dann in der Dropdownliste aus`MediaTailor/AdDecisionServerInteractions`.
1. (Optional) Passen Sie den Zeitraum an, den Sie untersuchen möchten.
1. (Optional) Ändern Sie die Abfrage im Dialogfeld. Allgemeine Hinweise finden Sie unter [CloudWatch Logs Insights-Abfragesyntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Beispiele für Abfragen für MediaTailor ADS finden Sie unter [Abfragen der ADS-Protokolle](querying-the-ads-logs.md).
1. Wählen Sie **Abfrage ausführen**. Die Abfrage kann einige Sekunden dauern. Während dieser Zeit erscheint **Cancel** (Abbrechen) anstelle von **Run query** (Abfrage ausführen).
1. (Optional) Um die Ergebnisse als CSV-Datei zu exportieren, wählen Sie **Actions** (Aktionen) und dann **Download query results (CSV)** (Abfrageergebnisse herunterladen) aus.
**Anmerkung**
Die Konsole begrenzt die Anzahl der Datensätze, die sie in Abfrageergebnissen zurückgibt und die sie exportiert. Verwenden Sie daher für Massendaten die API, das AWS Command Line Interface (AWS CLI) oder ein SDK.
**Topics**
+ [Abfragen der ADS-Protokolle](querying-the-ads-logs.md)
# Abfragen der ADS-Protokolle
CloudWatch Logs Insights bietet eine Vielzahl von Optionen zum Abfragen Ihrer Logs. Ausführliche Informationen zur Abfragesyntax finden Sie unter [CloudWatch Logs Insights-Abfragesyntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). In diesem Abschnitt finden Sie Beispiele für gängige Abfragen für den Einstieg in Ihre ADS-Protokollabfragen. Alle Abfragen werden über die Protokolle für die aktuelle Zeitbereichseinstellung ausgeführt.
Die folgende Abfrage ruft alle Informationen aus den ADS-Protokollen ab.
```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```
Die folgende Abfrage ruft alle Anforderungen an den ADS ab. Diese Abfrage zeigt eine Möglichkeit, den Inhalt des Anforderungsheaders für MediaTailor Logs abzurufen.
```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```
Die folgende Abfrage ruft die Anzeigen ab, die für eine bestimmte Sitzung MediaTailor eingefügt wurden.
```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```
Die folgende Abfrage ruft das Tracking ab URLs , das im MediaTailor Namen des Spielers aufgerufen wurde.
```
fields @timestamp, beaconInfo.trackingEvent, beaconInfo.beaconUri, beaconInfo.headers.0.value as @userAgent, beaconInfo.headers.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "BEACON_FIRED"
| sort @timestamp asc
```
Die folgende Abfrage ruft Informationen für eine bestimmte Wiedergabesitzung ab, indem die Ergebnisse nach `sessionId` gefiltert werden.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```
Die folgende Abfrage ruft Informationen für eine einzelne Anforderung ab, indem die Ergebnisse nach `requestId` gefiltert werden.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```
Die folgende Abfrage ruft die Anzahl der Protokolleinträge für jeden Ereignistyp ab, der protokolliert wurde.
```
fields eventType
| stats count() as @eventCount by eventType
```
Die folgende Abfrage ruft die Avail-ID und die Liste übersprungener Anzeigen für alle Avails ab, für die Anzeigen übersprungen wurden.
```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```
# Steuerung des Volumens der Logs AWS Elemental MediaTailor
MediaTailor Sitzungsprotokolle zum Einfügen von Anzeigen sind manchmal ausführlich. Um die Protokollkosten zu senken, können Sie den Prozentsatz der Sitzungsprotokolle definieren, die MediaTailor an Amazon CloudWatch Logs gesendet werden. Wenn Ihre Wiedergabekonfiguration beispielsweise 1000 Sitzungen zum Einfügen von Werbeanzeigen umfasst und Sie einen aktivierten Prozentwert von festlegen`60`, werden Protokolle für 600 der Sitzungen an CloudWatch Logs MediaTailor gesendet. MediaTailor entscheidet nach dem Zufallsprinzip, für welche der Sitzungen Protokolle gesendet werden sollen. Wenn Sie Protokolle für eine bestimmte Sitzung anzeigen möchten, können Sie den [Debug-Protokollmodus](debug-log-mode.md) verwenden.
Wenn Sie einen Prozentsatz für die Protokollierung festlegen, MediaTailor wird automatisch eine mit dem Dienst verknüpfte Rolle erstellt, MediaTailor die die zum Schreiben von CloudWatch Protokollen in Ihr Konto erforderlichen Berechtigungen gewährt. Informationen zur MediaTailor Verwendung von dienstbezogenen Rollen finden Sie unter. [Verwenden von serviceverknüpften Rollen für MediaTailor](using-service-linked-roles.md)
## Eine Protokollkonfiguration erstellen
Um den Prozentsatz der Sitzungsprotokolle zu kontrollieren, die in CloudWatch Protokolle MediaTailor geschrieben werden, erstellen Sie eine *Protokollkonfiguration* für Ihre Wiedergabekonfiguration. Wenn Sie eine Protokollkonfiguration erstellen, geben Sie einen *Namen für die Wiedergabekonfiguration* und einen *aktivierten Prozentwert* an.
------
#### [ Console ]
**Um eine Protokollkonfiguration für eine *bestehende* Wiedergabekonfiguration zu erstellen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Bereich **Wiedergabekonfiguration** die Wiedergabekonfiguration aus, für die Sie die Protokollkonfiguration festlegen möchten.
1. Wählen Sie **Bearbeiten** aus.
1. Geben **Sie unter Protokollkonfiguration** einen Wert für die **Aktivierung in Prozent** an.
**Um eine Protokollkonfiguration für eine *neue* Wiedergabekonfiguration zu erstellen**
+ Folgen Sie dem Verfahren unter [Konfiguration protokollieren](configurations-create.md#configurations-log-configurations).
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Um eine Protokollkonfiguration für eine *bestehende* Wiedergabekonfiguration zu erstellen**
Um eine Protokollkonfiguration mit dem zu erstellen AWS CLI, führen Sie den Befehl [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) aus und geben Sie die entsprechenden Werte für die erforderlichen Parameter an.
Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\$1) zur Verbesserung der Lesbarkeit.
```
$ aws mediatailor configure-logs-for-playback-configuration \
--percent-enabled 10 \
--playback-configuration-name MyPlaybackConfiguration
```
Dieses Beispiel ist für Microsoft Windows formatiert und verwendet das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern.
```
C:\> aws mediatailor configure-logs-for-playback-configuration ^
--percent-enabled 10 ^
--playback-configuration-name MyPlaybackConfiguration
```
Wobei Folgendes gilt:
+ `percent-enabled`ist der Prozentsatz der Sitzungsprotokolle zur Wiedergabekonfiguration, der an Logs gesendet wird. MediaTailor CloudWatch
+ `playback-configuration-name`ist der Name der Wiedergabekonfiguration, für die die Protokollkonfigurationseinstellungen festgelegt werden sollen.
Wird der Befehl erfolgreich ausgeführt, erhalten Sie eine Ausgabe ähnlich der folgenden:
```
{
"PercentEnabled": 10,
"PlaybackConfigurationName": "MyPlaybackConfiguration"
}
```
**Um eine Protokollkonfiguration für eine *neue* Wiedergabekonfiguration zu erstellen**
+ Verwenden Sie die `configure-logs-for-playback-configuration` Option für den [put-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html)Befehl.
------
## Deaktivierung einer Protokollkonfiguration
*Nachdem Sie eine Protokollkonfiguration erstellt haben, können Sie sie nicht löschen — Sie können sie nur deaktivieren.* Um die Protokollkonfiguration zu deaktivieren, setzen Sie in der MediaTailor Konsole oder API den Wert für die **Aktivierung in Prozent** auf **0**. Dadurch wird die gesamte Sitzungsprotokollierung für diese Wiedergabekonfiguration deaktiviert.
Wenn Sie die dienstbezogene Rolle löschen möchten, die für die Protokollkonfiguration (en) in Ihrem Konto MediaTailor verwendet wird, müssen Sie zunächst alle Protokollkonfigurationen deaktivieren. Informationen zum Löschen der dienstverknüpften Rolle finden Sie unter. [Verwenden von serviceverknüpften Rollen für MediaTailor](using-service-linked-roles.md)
------
#### [ Console ]
**So deaktivieren Sie die Protokollkonfiguration für eine Wiedergabekonfiguration**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Bereich **Wiedergabekonfiguration** die Wiedergabekonfiguration aus, für die Sie die Protokollkonfiguration deaktivieren möchten.
1. Wählen Sie **Bearbeiten** aus.
1. Stellen **Sie unter Protokollkonfiguration** den Wert für **Prozent aktiviert** auf ein`0`. Dadurch wird die gesamte Sitzungsprotokollierung für diese Wiedergabekonfiguration deaktiviert.
1. Wählen Sie **Speichern** aus.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Um eine Protokollkonfiguration zu deaktivieren**
+ Stellen Sie den `percent-enabled` Wert `0` mit dem Befehl [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) auf ein.
------
# Filterung von AWS Elemental MediaTailor Protokollen und Ereignissen
Protokolle, die von einer Wiedergabekonfiguration in ausgegeben werden, MediaTailor enthalten Informationen über eine Vielzahl von Aktivitäten, die während der Wiedergabesitzung stattfinden. Diese Aktivitäten werden im Ereignistyp der Protokolle identifiziert. Viele Ereignisse werden standardmäßig protokolliert. Um die Kosten für Logs in Amazon unter Kontrolle zu halten CloudWatch, können Sie angeben, welche Logs ausgegeben MediaTailor werden.
MediaTailor bietet Ihnen die Kontrolle über die Protokollfilterung, sodass Sie Folgendes tun können:
+ Geben Sie die Protokollereignisse an, die Sie aus den Protokollen ausschließen möchten
+ Aktivieren Sie die Protokollierung von Rohantworten vom AD Decision Server (ADS)
Sie können diese Einstellungen für die Protokollfilterung unabhängig für jede Wiedergabesitzung oder als Standard für alle Wiedergabesitzungen für eine Wiedergabekonfiguration festlegen.
+ Um Protokolle pro Sitzung zu filtern, fügen Sie Abfrageparameter in die Initialisierungsanfrage für die Wiedergabe-Sitzung ein.
+ Um Protokolle auf Basis der Konfiguration pro Wiedergabe zu filtern, verwenden Sie die MediaTailor Konsole oder die API, um Ihre Präferenzen in den Einstellungen für die Wiedergabekonfiguration anzugeben.
Die folgenden Abschnitte enthalten Anweisungen zur Aktivierung der Protokollfilterung für Sitzungen und Wiedergabekonfigurationen.
# Protokollfilter pro Sitzung
Um für jede Sitzung eine benutzerdefinierte Ebene der Protokolldetails zu definieren, fügen Sie die folgenden Parameter an Ihre erste server- oder clientseitige Wiedergabe-Sitzungsanforderung an. Fügen Sie den Parametern Werte hinzu, um die Ereignisse darzustellen, die Sie ein- oder ausschließen möchten, und zwar in einem kommagetrennten Format:
+ `aws.adsInteractionLogPublishOptInEventTypes`um Protokolle für bestimmte Interaktionen mit dem AD Decision Server (ADS) zu erhalten.
+ `aws.adsInteractionLogExcludeEventTypes`um den Empfang von Protokollen für bestimmte ADS-Interaktionen zu beenden.
+ `aws.manifestServiceLogExcludeEventTypes`um den Empfang von Protokollen für bestimmte Manifest-Dienstinteraktionen zu beenden.
Eine Liste der Protokoll- und MediaTailor Ereignistypen, die ausgesendet werden, finden Sie unter [Manifest-Protokolle](log-types.md)[ADS-Protokolle](ads-log-format.md), und[Protokolle transkodieren](tm-log-format.md).
Wenn Sie keine Abfrageparameter für die Protokollfilterung übergeben, werden alle Protokolle an Ihr Lieferziel MediaTailor geschrieben.
**Example serverseitige Sitzungsinitialisierung mit Protokollfiltern**
Um `PARSING_ERROR` Ereignisse aus Ihren Manifestprotokollen und `MAKING_ADS_REQUEST` aus den ADS-Protokollen auszuschließen`GENERATED_MANIFEST`, würde die Anfrage zur Sitzungsinitialisierung wie folgt aussehen:
```
GET /v1/master///index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST
```
Um Rohprotokolle aus Ihrem ADS zu aktivieren, geben Sie den `RAW_ADS_RESPONSE` Wert für den `AdsInteractionPublishOptInEventType` Parameter an:
```
GET /v1/master///index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE
```
**Example clientseitige Sitzungsinitialisierung mit Protokollfiltern**
Um Protokollereignisse während der clientseitigen Sitzungsinitialisierung auszuschließen, fügen Sie Parameter in die POST-Anfrage Ihres Clients ein `availSuppression` und protokollieren Sie sie. MediaTailor Weitere Hinweise zum Erstellen einer clientseitigen Wiedergabesitzungsanforderung finden Sie unter [Kundenseitiges Anzeigen-Tracking](ad-reporting-client-side.md). Im folgenden Beispiel werden `PARSING_ERROR` Ereignisse aus Ihren Manifestprotokollen `CONFIG_SECURITY_ERROR` und aus den ADS-Protokollen ausgeschlossen. `MAKING_ADS_REQUEST`
```
POST parent.m3u8
{
"adsInteractionLog": {
...
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
}
```
Um Rohprotokolle aus Ihrem ADS zu aktivieren, geben Sie den `RAW_ADS_RESPONSE ` Wert für den `publishOptInEventTypes` Parameter an:
```
POST parent.m3u8
{
"adsInteractionLog": {
"publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
}
```
# Protokollfilter für die Konfiguration pro Wiedergabe
Verwenden Sie die Einstellungen der Wiedergabekonfiguration, um die Protokoll-Ereignistypen zu definieren, die MediaTailor standardmäßig von dieser Wiedergabekonfiguration ausgegeben werden. MediaTailor verwendet diese Standardeinstellungen für die Protokollfilterung für alle Sitzungen, die keine Filterabfrageparameter in der Sitzungsstartanforderung enthalten.
Sie können wählen, ob Sie Folgendes tun möchten:
+ Empfangen Sie Protokolle für bestimmte Interaktionen mit dem Ad Decision Server (ADS).
+ Schließen Sie Protokolle für bestimmte ADS-Interaktionen aus.
+ Schließen Sie Protokolle für bestimmte manifeste Dienstinteraktionen aus.
Informationen zum Einstellen dieser Einstellungen von der MediaTailor Konsole aus finden Sie unter[Konfiguration erstellen](configurations-create.md). Informationen zur MediaTailor API finden Sie [https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html)in der *AWS Elemental MediaTailor API-Referenz*.
Eine Liste der Protokoll- und MediaTailor Ereignistypen, die ausgegeben werden, finden Sie unter [Manifest-Protokolle](log-types.md)[ADS-Protokolle](ads-log-format.md), und[Protokolle transkodieren](tm-log-format.md).
# AWS Elemental MediaTailor Debug-Protokolle werden generiert
Verwenden Sie Debug-Protokolle, um Probleme bei der Wiedergabesitzung beim Einfügen von MediaTailor Anzeigen zu beheben. Um Debug-Logs zu generieren, stellen Sie in der Anfrage des Players den Protokollmodus auf Debuggen ein. MediaTailor *Stellen Sie für serverseitige Berichte den Protokollmodus in der Wiedergabeanforderung ein.* Für clientseitige Berichte legen Sie den Protokollmodus in der Anforderung zur *Sitzungsinitialisierung* fest.
Wenn der Protokollmodus auf Debug gesetzt ist, werden alle Protokollereignistypen in das Verzeichnis Logs MediaTailor geschrieben. CloudWatch Die Protokolle enthalten Informationen zu den folgenden Ereignissen. Eine vollständige Liste der in den Debug-Protokollen erzeugten Daten finden Sie unter [Debug-Protokollfelder](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html#debug-log-mode-fields).
+ **Origin-Interaktion** — Details zu MediaTailor Interaktionen mit dem Ursprungsserver. Zum Beispiel die Antwort auf das Ursprungs-Manifest, der Manifesttyp und die Quell-URL.
+ **Generiertes Manifest** — Details zur Antwort auf die Playback-Sitzung von MediaTailor. Zum Beispiel das Manifest, das MediaTailor generiert wird.
+ **Sitzung initialisiert** — Details zur Sitzungsinitialisierung, z. B. die Sitzungs-ID.
Informationen zum Anpassen der Protokollereignistypen, die Sie pro Sitzung erhalten, finden Sie unter. [Filterung von Protokollen und Ereignissen](logs-filter.md)
## Voraussetzungen
Um den Protokollmodus auf Debug einzustellen, müssen Sie zunächst die MediaTailor Erlaubnis zum Senden von Protokollen an erteilen CloudWatch, falls Sie dies noch nicht getan haben. Sobald Sie die Zugriffsberechtigung MediaTailor erteilt haben CloudWatch, können Sie den Debug-Protokollmodus aktivieren. Informationen zum Erteilen von MediaTailor Zugriffsberechtigungen CloudWatch finden Sie unter [Berechtigungen für Amazon einrichten CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-permissions.html).
## Wie stelle ich den Protokollmodus auf Debug ein
In diesem Abschnitt wird erklärt, wie Sie den Protokollmodus für serverseitige und clientseitige Berichte auf Debug einstellen.
### Serverseitige Berichterstattung
Fügen Sie für serverseitige Berichte den `?aws.logMode=DEBUG` Abfrageparameter und den Wert in die Wiedergabeanforderung Ihres `GET HTTP` Players an den HLS- oder DASH-Endpunkt ein. MediaTailor [Allgemeine Informationen zur serverseitigen Berichterstattung finden Sie unter Serverseitige Berichterstattung.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-server-side.html)
**Wichtig**
Bei `DEBUG`-Wert ist die Groß- und Kleinschreibung zu beachten.
Eine Wiedergabeanforderung, die Folgendes beinhaltet, `?aws.logMode=DEBUG` sieht wie folgt aus:
**Example Wiedergabeanforderung an einen HLS-Endpunkt**
```
GET /v1/master///?aws.logMode=DEBUG
```
Nachdem Sie den Protokollmodus auf Debug gesetzt haben, empfehlen wir Ihnen, zu überprüfen, ob die Debug-Protokollierungssitzung aktiv ist. Um zu überprüfen, ob die Debug-Sitzung aktiv ist, überprüfen Sie, ob CloudWatch Protokolle für die Sitzungs-ID vorhanden sind. Die Sitzungs-ID ist im Wiedergabeendpunkt enthalten, der dies MediaTailor bereitstellt. Weitere Informationen finden Sie unter [Verify that the debug log mode is active for your playback session](#debug-active).
### Clientseitige Berichterstattung
Für die clientseitige Berichterstattung fügen Sie den `logMode` Schlüssel und den `DEBUG` Wert in den Text der Anfrage zur `POST HTTP` Sitzungsinitialisierung Ihres Clients in den /v1/session-Endpunkt ein. MediaTailor [Allgemeine Informationen zur clientseitigen Berichterstattung finden Sie unter Clientseitige Berichterstattung.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-client-side.html)
**Wichtig**
Bei `DEBUG`-Wert ist die Groß- und Kleinschreibung zu beachten.
Nachdem Sie den Protokollmodus auf Debug gesetzt haben, empfehlen wir Ihnen, zu überprüfen, ob die Debugsitzung aktiv ist. Um zu überprüfen, ob die Debug-Sitzung aktiv ist, vergewissern Sie sich, dass in den Protokollen ein `SESSION_INITIALIZED` Ereignis mit der Sitzungs-ID verknüpft ist. CloudWatch Die Sitzungs-ID ist im Wiedergabeendpunkt enthalten, der Folgendes MediaTailor bereitstellt. Weitere Informationen finden Sie unter [Verify that the debug log mode is active for your playback session](#debug-active).
## Maximale Anzahl aktiver Debug-Sitzungen
Sie können maximal 10 aktive Debug-Protokollsitzungen haben. Wenn Ihr Player seine Anfrage zur Sitzungsinitialisierung oder Wiedergabe an sendet MediaTailor, wird MediaTailor überprüft, ob das Limit erreicht wurde. Ist dies der Fall, wird MediaTailor überprüft, ob es veraltete Sessions gibt. Eine Sitzung ist veraltet, wenn innerhalb eines bestimmten Zeitraums nicht darauf zugegriffen wurde. Bei Live-Streams beträgt dieser Zeitraum 10 Minuten, bei VOD-Streams 30 Minuten.
Wenn das maximale Limit für aktive Debug-Protokollsitzungen erreicht wurde, werden Debug-Protokolle für Ihre Sitzung nicht in die CloudWatch Protokolle geschrieben. Wenn Sie in den Protokollen für Ihre Sitzung keine CloudWatch Debug-Protokolle sehen, haben Sie dieses Limit möglicherweise erreicht. Informationen darüber, ob das Limit erreicht wurde, finden Sie unter[Verify that the debug log mode is active for your playback session](#debug-active).
## Debuggen von Protokollfeldern
In der folgenden Tabelle sind die Debug-Logfelder aufgeführt, in die MediaTailor geschrieben wird. CloudWatch
| Feld | Description |
| --- | --- |
| awsAccountId | Ihre AWS-Konto ID. |
| customerId | Ihre MediaTailor Kundennummer. |
| eventTimestamp | Der ISO 8601-Zeitstempel, der dem Debug-Log-Ereignis zugeordnet ist. |
| eventType | Der Typ des Debug-Protokollereignisses. Werte:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/debug-log-mode.html) |
| originRequestUrl | Die URL Ihres Ursprungsservers, der für diese Anfrage abgerufen wird. |
| mediaTailorPath | Der MediaTailor Endpunkt, der aufgerufen wurde, einschließlich aller Parameter, die MediaTailor in der ersten Manifestanforderung übergeben wurden. |
| requestId | Die ID einer bestimmten HTTP-Anfrage an MediaTailor. |
| responseBody | Das Manifest im Antworttext von MediaTailor. Dies ist entweder das rohe Ursprungsmanifest oder das von generierte Manifest MediaTailor. |
| sessionId | Die ID der Wiedergabe-Sitzung. |
| sessionType | Die Art der Wiedergabesitzung. Werte: `HLS`, `DASH` |
## Lesen Sie die Debug-Protokolle
MediaTailor schreibt die Debug-Logs in Amazon CloudWatch Logs. Es fallen typische CloudWatch Logs-Gebühren an. Verwenden Sie CloudWatch Insights, um die Debug-Logs zu lesen. Informationen zur Verwendung von CloudWatch Logs Insights finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) im *AWS CloudWatch Logs-Benutzerhandbuch*.
**Anmerkung**
Es kann einige Minuten dauern, bis die Debug-Protokolle angezeigt werden. CloudWatch Wenn Sie die Protokolle nicht sehen, warten Sie ein paar Minuten und versuchen Sie es erneut. Wenn Sie die Protokolle immer noch nicht sehen, haben Sie möglicherweise die maximale Anzahl aktiver Debug-Protokollsitzungen erreicht. Um zu überprüfen, ob dies der Fall ist, führen Sie eine CloudWatch Abfrage aus, um festzustellen, ob für Ihre Playback-Sitzung eine Debug-Sitzung initialisiert wurde. Weitere Informationen finden Sie unter [Verify that the debug log mode is active for your playback session](#debug-active).
### Beispiele
Dieser Abschnitt enthält Beispielabfragen, mit denen Sie MediaTailor Debug-Protokolldaten lesen können.
**Example 1: Stellen Sie sicher, dass der Debug-Protokollmodus für Ihre Wiedergabesitzung aktiv ist**
```
fields @timestamp, @message
| filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
| filter eventType = "SESSION_INITIALIZED" # client-side reporting
or mediaTailorPath like “/v1/master" # server-side reporting HLS
or mediaTailorPath like “/v1/dash" # server-side reporting DASH
```
**Example 2: Sehen Sie sich die Antworten von Ihrem Absender an**
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
```
**Example 3: Sehen Sie sich das Manifest an, das von MediaTailor für eine bestimmte Sitzung generiert wurde**
```
fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
```
**Example 4: Alle Ereignisse für eine bestimmte Zeit anzeigen `requestId`**
Verwenden Sie diese Abfrage, um das Ursprungsmanifest und das von generierte Manifest anzuzeigen MediaTailor.
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
```
# Überwachung AWS Elemental MediaTailor mit CloudWatch Amazon-Metriken
Sie können AWS Elemental MediaTailor Metriken überwachen mit CloudWatch. CloudWatch sammelt Rohdaten über die Leistung des Dienstes und verarbeitet diese Daten zu lesbaren Metriken, die nahezu in Echtzeit verfügbar sind. Diese Statistiken werden 15 Monate gespeichert, damit Sie auf Verlaufsinformationen zugreifen können und einen besseren Überblick darüber erhalten, wie Ihre Webanwendung oder der Service ausgeführt werden. Sie können auch Alarme einrichten, die auf bestimmte Grenzwerte achten und Benachrichtigungen senden oder Aktivitäten auslösen, wenn diese Grenzwerte erreicht werden. Weitere Informationen finden Sie im [ CloudWatch Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
Metriken können nützlich sein, wenn Sie veraltete Manifeste untersuchen. Weitere Informationen finden Sie unter [Verwendung von Metriken zur Diagnose veralteter Manifeste](stale-manifest-diagnose.md).
Metriken werden zunächst nach dem Service-Namespace und anschließend nach den verschiedenen Dimensionskombinationen in den einzelnen Namespaces gruppiert.
**So zeigen Sie Metriken mit der Konsole an CloudWatch**
1. Ö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 unter **Alle Metriken** den **MediaTailor**Namespace aus.
1. Wählen Sie zur Ansicht der Metriken die Metrikdimension aus (z. B. **originID**).
1. Geben Sie den Zeitraum an, den Sie anzeigen möchten.
**Um Metriken mit dem AWS Command Line Interface ()AWS CLI anzuzeigen**
+ Geben Sie in einer Eingabeaufforderung den folgenden Befehl ein:
```
aws cloudwatch list-metrics --namespace "AWS/MediaTailor"
```
## AWS Elemental MediaTailor CloudWatch Metriken
Der AWS Elemental MediaTailor Namespace umfasst die folgenden Metriken. Diese Metriken werden standardmäßig in Ihrem Konto veröffentlicht.
### Metriken von Channel Assembly (CA)
In der folgenden Tabelle sind alle Metriken nach Kanal oder nach Kanalausgabe verfügbar.
| Metrik | Description |
| --- | --- |
| 4xxErrorCount | Die Anzahl der `4xx` Fehler. |
| 5xxErrorCount | Die Anzahl der `5xx` Fehler. |
| RequestCount | Die Gesamtanzahl der -Anforderungen. Die Anzahl der Transaktionen hängt weitgehend davon ab, wie oft Spieler aktualisierte Manifeste anfordern und wie viele Spieler sie haben. Jede Player-Anforderung zählt als eine Transaktion. |
| TotalTime | Die Zeit, die der Anwendungsserver für die Bearbeitung der Anfrage benötigte, einschließlich der Zeit, die für den Empfang und das Schreiben von Bytes vom Client und vom Netzwerk benötigt wurde. |
#### Metriken zum serverseitigen Einfügen von Werbung (SSAI)
In der folgenden Tabelle sind Metriken zum Einfügen von serverseitiger Werbung aufgeführt.
| Metrik | Description |
| --- | --- |
| AdDecisionServer.Ads | Die Anzahl der Anzeigen, die in den Antworten des Ad Decision Servers (ADS) innerhalb des von Ihnen CloudWatch angegebenen Zeitraums enthalten waren. |
| AdDecisionServer.Duration | Die Gesamtdauer in Millisekunden aller Anzeigen, die innerhalb des von Ihnen angegebenen CloudWatch Zeitraums vom ADS MediaTailor empfangen wurden. Diese Dauer kann länger als die von Ihnen angegebene Dauer `Avail.Duration` sein. |
| AdDecisionServer.Errors | Die Anzahl der Antworten mit 200-Statuscode, die nicht über HTTP erfolgen, der leeren Antworten und der Antworten mit Timeout, die innerhalb des von Ihnen angegebenen CloudWatch Zeitraums vom ADS MediaTailor empfangen wurden. |
| AdDecisionServer.FillRate | Der einfache Durchschnitt der Raten, mit denen die Antworten vom ADS die entsprechenden einzelnen Ad-Avails für den von Ihnen angegebenen Zeitraum gefüllt haben. Um den gewichteten Durchschnittswert zu erhalten, berechnen Sie die `AdDecisionServer.Duration` als Prozentsatz der `Avail.Duration`. Weitere Informationen über einfache und gewichtete Durchschnittswerte finden Sie unter [Einfache und gewichtete Durchschnittswerte](#metrics-simple-average). |
| AdDecisionServer.Latency | Die Antwortzeit in Millisekunden für Anfragen an das ADS. MediaTailor |
| AdDecisionServer.Timeouts | Die Anzahl der Anfragen an das ADS, bei denen das Timeout in dem von Ihnen angegebenen CloudWatch Zeitraum überschritten wurde. |
| AdNotReady | Gibt an, wie oft der ADS in dem von Ihnen angegebenen Zeitraum auf eine Anzeige verwiesen hat, die von dem internen Transcoder-Service noch nicht transcodiert worden war. Ein hoher Wert für diese Metrik kann zu einem niedrigen Gesamtwert für `Avail.FillRate` betragen. |
| AdsBilled | Die Anzahl der Anzeigen, für die Kunden MediaTailor Rechnungen auf der Grundlage der Insertion in Rechnung gestellt werden. |
| Avail.Duration | Die geplante Gesamtzahl der Millisekunden, an denen die Anzeige innerhalb des Zeitraums verfügbar ist. CloudWatch Die geplante Gesamtzahl basiert auf der Dauer der Anzeigenverfügbarkeit im Ursprungsmanifest. |
| Avail.FilledDuration | Die geplante Anzahl von Millisekunden an Werbeanzeigen, die innerhalb des Zeitraums mit MediaTailor Werbeanzeigen gefüllt werden. CloudWatch |
| Avail.FillRate | Der geplante einfache Durchschnitt der Raten, zu denen einzelne Anzeigen innerhalb des Zeitraums geschaltet MediaTailor werden. CloudWatch Um den gewichteten Durchschnittswert zu erhalten, berechnen Sie die `Avail.FilledDuration` als Prozentsatz der `Avail.Duration`. Weitere Informationen über einfache und gewichtete Durchschnittswerte finden Sie unter [Einfache und gewichtete Durchschnittswerte](#metrics-simple-average). Welchen Wert MediaTailor maximal für `Avail.FillRate` erzielen kann, ist von dem Wert für `AdDecisionServer.FillRate` abhängig. Wenn der Wert für `Avail.FillRate` niedrig ist, vergleichen Sie ihn mit dem Wert für `AdDecisionServer.FillRate`. Wenn die `AdDecisionServer.FillRate` niedrig ist, gibt Ihr ADS möglicherweise nicht genügend Werbung für die Avail-Dauer zurück. |
| Avail.Impression | Die Anzahl der Anzeigen mit Impressions-Tracking-Ereignissen, die beim MediaTailor serverseitigen Beaconing beobachtet werden (nicht die Anzahl der Impressionen). |
| Avail.ObservedDuration | Die beobachtete Gesamtzahl der Millisekunden an Anzeigenzugriffen innerhalb des Zeitraums. CloudWatch `Avail.ObservedDuration`wird am Ende der Werbeanzeige ausgegeben und basiert auf der Dauer der Segmente, über die während der Verfügbarkeit der Anzeige im Manifest berichtet wurde. |
| Avail.ObservedFilledDuration | Die beobachtete Anzahl von Millisekunden der Werbeanzeige, die innerhalb des Zeitraums mit Werbeanzeigen MediaTailor gefüllt wurde. CloudWatch |
| Avail.ObservedFillRate | Der beobachtete einfache Durchschnitt der Raten, MediaTailor mit denen gefüllte einzelne Anzeigen innerhalb des Zeitraums geschaltet wurden. CloudWatch Wird nur für HLS-Manifeste beim ersten `CUE-IN` Tag ausgegeben. Wenn kein `CUE-IN` Tag vorhanden ist, wird diese Metrik MediaTailor nicht ausgegeben. |
| Avail.ObservedSlateDuration | Die beobachtete Gesamtzahl der Millisekunden von Schiefer, die innerhalb des Zeitraums eingefügt wurden. CloudWatch |
| GetManifest.Age | Das Gesamtalter des Manifests in Millisekunden. Gemessen von dem Zeitpunkt, zu dem der Ursprung das Manifest erstellt, bis zu dem Zeitpunkt, zu dem das personalisierte Manifest MediaTailor gesendet wird. Weitere Informationen zu Metriken zur Messung des Alters von Manifesten finden Sie unter[Verwendung von Metriken zur Diagnose veralteter Manifeste](stale-manifest-diagnose.md). |
| GetManifest.Errors | Die Anzahl der Fehler, die MediaTailor beim Generieren von Manifesten in dem von Ihnen angegebenen CloudWatch Zeitraum aufgetreten sind. |
| GetManifest.Latency | Die MediaTailor Antwortzeit in Millisekunden für die Anforderung zur Generierung von Manifesten. Weitere Informationen zu Metriken zur Messung des Alters von Manifesten finden Sie unter. [Verwendung von Metriken zur Diagnose veralteter Manifeste](stale-manifest-diagnose.md) |
| GetManifest.MediaTailorAge | Die Zeitspanne in Millisekunden, MediaTailor in der das Manifest gespeichert wurde. Gemessen vom MediaTailor Empfang einer ursprünglichen Antwort bis zum Versand des personalisierten MediaTailor Manifests. Weitere Informationen zu Metriken zur Messung des Alters von Manifesten finden Sie unter[Verwendung von Metriken zur Diagnose veralteter Manifeste](stale-manifest-diagnose.md). |
| Origin.Age | Die Zeitspanne in Millisekunden, für die der Ursprung das Manifest hat. Gemessen von dem Zeitpunkt, zu dem der Ursprung das Manifest erstellt, bis zu dem Zeitpunkt, an dem die ursprüngliche MediaTailor Anfrage gesendet wird. Alle `origin.*` Metriken werden für Anfragen ausgegeben, die direkt vom Ursprung aus erfüllt werden. Sie werden nicht für zwischengespeicherte Ausgangsantworten ausgegeben. Weitere Informationen zu Metriken zur Messung des Manifestalters finden Sie unter[Verwendung von Metriken zur Diagnose veralteter Manifeste](stale-manifest-diagnose.md). |
| Origin.Errors | Die Anzahl der 200-Statuscode-Antworten ohne HTTP-Status und der Antworten mit Timeout, die in dem von Ihnen angegebenen CloudWatch Zeitraum vom Ursprungsserver MediaTailor empfangen wurden. Alle `origin.*` Messwerte werden für Anfragen ausgegeben, die direkt vom Ursprung aus erfüllt werden. Sie werden nicht für zwischengespeicherte Ausgangsantworten ausgegeben. |
| Origin.ManifestFileSizeBytes | Die Dateigröße des Ursprungs-Manifests in Byte für HLS und DASH. In der Regel wird diese Metrik in Verbindung mit `Origin.ManifestFileSizeTooLarge` verwendet. Alle `origin.*` Metriken werden für Anfragen ausgegeben, die direkt vom Ursprung aus erfüllt werden. Sie werden nicht für zwischengespeicherte Ausgangsantworten ausgegeben. |
| Origin.ManifestFileSizeTooLarge | Die Anzahl der Antworten vom Ursprung, deren Manifestgröße die konfigurierte Menge übersteigt. In der Regel wird diese Metrik in Verbindung mit verwendet`Origin.ManifestFileSizeBytes`. Alle `origin.*` Metriken werden für Anfragen ausgegeben, die direkt vom Ursprung aus erfüllt werden. Sie werden nicht für zwischengespeicherte Ausgangsantworten ausgegeben. |
| Origin.Timeouts | Die Anzahl der Anfragen an den Ursprungsserver, bei denen das Timeout in dem von Ihnen angegebenen CloudWatch Zeitraum überschritten wurde. Alle `origin.*` Metriken werden für Anfragen ausgegeben, die direkt vom Ursprung aus erfüllt werden. Sie werden nicht für zwischengespeicherte Ausgangsantworten ausgegeben. |
| Requests | Die Anzahl gleichzeitiger Transaktionen pro Sekunde für alle Anforderungstypen. Die Anzahl der Transaktionen hängt hauptsächlich von der Anzahl der Spieler ab und davon, wie oft die Spieler aktualisierte Manifeste anfordern. Jede Player-Anforderung zählt als eine Transaktion. |
| SkippedReason.DurationExceeded | Die Anzahl der Anzeigen, die nicht in eine Avail eingefügt wurden, weil die ADS eine Anzeigendauer zurückgab, die über der angegebenen Verfügbarkeitsdauer lag. Ein hoher Wert für diese Kennzahl kann zu einer Diskrepanz zwischen der Metrik und beitragen. `Avail.Ads` `AdDecisionServer.Ads` Weitere Informationen zu den Gründen, warum Werbung übersprungen wurde, finden Sie unter. [Fehlerbehebung beim Überspringen von Anzeigen](troubleshooting-ad-skipping-overview.md) |
| SkippedReason.EarlyCueIn | Die Anzahl der Anzeigen, die aufgrund eines vorzeitigen Fehlers übersprungen wurden. `CUE-IN` |
| SkippedReason.ImportError | Die Anzahl der Anzeigen, die aufgrund eines Fehlers im Importjob übersprungen wurden. |
| SkippedReason.ImportInProgress | Die Anzahl der Anzeigen, die aufgrund eines vorhandenen aktiven Importauftrags übersprungen wurden. |
| SkippedReason.InternalError | Die Anzahl der Anzeigen, die aufgrund eines MediaTailor internen Fehlers übersprungen wurden. |
| SkippedReason.NewCreative | Die Anzahl der Anzeigen, die nicht in ein Avail eingefügt wurden, weil das Asset zum ersten Mal von einem Kunden angefordert wurde. Ein hoher Wert für diese Kennzahl kann vorübergehend zu einem niedrigen Gesamtwert führen`Avail.FillRate`, bis die Assets erfolgreich transkodiert werden können. |
| SkippedReason.NoVariantMatch | Die Anzahl der Anzeigen, die übersprungen wurden, weil es keine Variantenübereinstimmung zwischen der Anzeige und dem Inhalt gab. |
| SkippedReason.PersonalizationThresholdExceeded | Die Dauer von Anzeigen, die in dieser Konfiguration den für die **Personalisierung festgelegten Schwellenwert** überschreiten. |
| SkippedReason.ProfileNotFound | Die Anzahl der Anzeigen, die übersprungen wurden, weil das Transcodierungsprofil nicht gefunden wurde. |
| SkippedReason.TranscodeError | Die Anzahl der Anzeigen, die aufgrund eines Transcodierungsfehlers übersprungen wurden. |
| SkippedReason.TranscodeInProgress | Die Anzahl der Anzeigen, die nicht in einen Avail eingefügt wurden, weil die Anzeige noch nicht transkodiert wurde. Ein hoher Wert für diese Kennzahl kann vorübergehend zu einem niedrigen Gesamtwert führen`Avail.FillRate`, bis die Inhalte erfolgreich transkodiert werden können. |
| GetAssets.Requests | Die Anzahl der Asset List-Anfragen, die innerhalb des Zeitraums für HLS Interstitials-Sitzungen eingegangen sind. CloudWatch Verwenden Sie diese Kennzahl, um das Volumen verspäteter Bindungen und Entscheidungen zu überwachen und den Umfang der Nutzung von HLS Interstitials zu ermitteln. |
| GetAssets.Latency | Die Antwortzeit für Anfragen zur Inventarliste in Millisekunden für HLS Interstitials-Sitzungen. Überwachen Sie diese Kennzahl, um eine optimale Leistung bei der Entscheidungsfindung für Werbeanzeigen sicherzustellen und potenzielle Engpässe im Arbeitsablauf bei der späten Bindung zu identifizieren. |
**Anmerkung**
Bei HLS Interstitials-Sitzungen verhalten sich einige Kennzahlen aufgrund der spätverbindlichen Natur der Anzeigenentscheidungen unterschiedlich:
`Avail.ObservedFilledDuration`Treffer, `Avail.FilledDuration` da MediaTailor das tatsächliche Wiedergabeverhalten auf der Clientseite nicht beobachtet werden kann.
`Avail.ObservedSlateDuration`meldet die geplante Slate-Dauer anhand der Antworten auf die Asset-Liste und nicht anhand der beobachteten Wiedergabe.
Metriken mit dem Präfix „Observed“ liefern geschätzte Werte für HLS Interstitials-Sitzungen.
### Einfache und gewichtete Durchschnittswerte
Sie können den einfachen Durchschnitt und den gewichteten Durchschnitt für die Antworten des ADS auf Anzeigenanfragen von MediaTailor und für die Anzahl der MediaTailor verfügbaren Anzeigen abrufen:
+ Die *einfachen Durchschnittswerte* werden in `AdDecisionServer.FillRate` und `Avail.FillRate` angegeben. Dabei handelt es sich um die Durchschnittswerte der Füllraten in Prozent für einzelne Avails für den Zeitraum. Bei den einfachen Durchschnittswerten werden keine Unterschiede in der Dauer der einzelnen Avails berücksichtigt.
+ Die *gewichteten Durchschnittswerte* beziehen sich auf die prozentuale Füllrate für die Summe aller Werte der Avail-Dauer. Diese Werte werden als (`AdDecisionServer.Duration`\$1100)/`Avail.Duration` und (`Avail.FilledDuration`\$1100)/`Avail.Duration` berechnet. Diese Durchschnittswerte reflektieren die Unterschiede in der Dauer der einzelnen Ad-Avails, sodass solche mit längerer Dauer stärker gewichtet werden.
Für einen Zeitraum mit nur einem einzigen Ad-Avail entspricht der mit `AdDecisionServer.FillRate` angegebene einfache Durchschnitt dem mit (`AdDecisionServer.Duration`\$1100)/`Avail.Duration` angegebenen gewichteten Durchschnitt. Der mit `Avail.FillRate` angegebene einfache Durchschnitt entspricht dem mit (`Avail.FilledDuration`\$1100)/`Avail.Duration` angegebenen gewichteten Durchschnitt.
**Beispiel**
Angenommen, die von Ihnen angegebene Zeitspanne verfügt über die folgenden zwei Ad-Avails:
+ Die Dauer des ersten Ad-Avail beträgt 90 Sekunden:
+ Die ADS-Antwort für den Avail stellt 45 Sekunden an Werbung bereit (zu 50 % gefüllt).
+ MediaTailor füllt 45 Sekunden der verfügbaren Anzeigenzeit aus (50% gefüllt).
+ Die Dauer des zweiten Ad-Avail beträgt 120 Sekunden:
+ Die ADS-Antwort für den Avail stellt 120 Sekunden an Werbung bereit (zu 100 % gefüllt).
+ MediaTailor füllt 90 Sekunden der verfügbaren Werbezeit aus (75% gefüllt).
Die Metriken sind wie folgt:
+ Der Wert von `Avail.Duration` ist 120, nämlich die Summe der Dauer der beiden Ad-Avail-Zeiträume: 90 \$1 120.
+ `AdDecisionServer.Duration` ist 165, nämlich die Summe der beiden Werte der Antwortdauer: 45 \$1 120.
+ `Avail.FilledDuration` ist 135, nämlich die Summe der beiden Werte für die gefüllte Dauer: 45 \$1 90.
+ Der Wert von `AdDecisionServer.FillRate` ist 75 %, nämlich der gefüllte prozentuale Durchschnitt für jeden Avail: (50 %\$1100 %)/2. Dies ist der einfache Durchschnittswert.
+ Der gewichtete Durchschnittswert für die ADS-Füllraten ist 78,57 %, was dem Wert für `AdDecisionServer.Duration` als Prozentsatz des Wertes für `Avail.Duration` entspricht: (165\$1100)/210. Diese Berechnung berücksichtigt die Unterschiede bezüglich der Dauer.
+ Der Wert von `Avail.FillRate` ist 62.5 %, nämlich der gefüllte prozentuale Durchschnitt für jeden Avail: (50 %\$175 %)/2. Dies ist der einfache Durchschnittswert.
+ Der gewichtete Durchschnitt der MediaTailor verfügbaren Füllraten liegt bei 64,29%, was einem Prozentsatz der folgenden `Avail.FilledDuration` Werte entspricht`Avail.Duration`: (135\$1100)/210. Diese Berechnung berücksichtigt die Unterschiede bezüglich der Dauer.
Der höchste Wert`Avail.FillRate`, der für jede MediaTailor verfügbare Anzeige erreicht werden kann, liegt bei 100%. Der ADS gibt möglicherweise mehr Werbezeit zurück, als im Avail verfügbar ist, MediaTailor kann aber nur den verfügbaren Zeitraum füllen.
## AWS Elemental MediaTailor CloudWatch Abmessungen
Sie können die AWS Elemental MediaTailor Daten anhand der folgenden Dimension filtern.
| Dimension | Description |
| --- | --- |
| `Configuration Name` | Gibt die Konfiguration an, zu der die Metrik gehört. |
# Verwenden von Metriken zur Diagnose veralteter Manifeste von AWS Elemental MediaTailor
Ein veraltetes Manifest ist ein Manifest, das in letzter Zeit nicht aktualisiert wurde. Bei verschiedenen Workflows zum Einfügen von Anzeigen kann es aufgrund einer Vielzahl von Faktoren (z. B. Anforderungen an nachgeschaltete Systeme) unterschiedlich sein, wie lange es dauern muss, bis ein Manifest als veraltet angesehen wird. Sie können CloudWatch Amazon-Metriken verwenden, um Manifeste zu identifizieren, die die Veraltungstoleranz für Ihren Workflow überschreiten, und dabei helfen, herauszufinden, was die Ursache für die Verzögerungen bei der Aktualisierung von Manifesten sein könnte.
Die folgenden Kennzahlen helfen dabei, veraltete Manifeste und ihre Ursachen zu identifizieren.
Informationen zu allen ausgegebenen Metriken MediaTailor finden Sie unter. [AWS Elemental MediaTailor CloudWatch Metriken](monitoring-cloudwatch-metrics.md#metrics)
| Metrik | Definition | Verwenden Sie |
| --- | --- | --- |
| GetManifest.Age | Misst das Gesamtalter des Manifests, einschließlich `GetManifest.MediaTailorAge` sowohl als auch `Origin.Age` für diese Konfiguration. | Sie können diese Metrik verwenden, um Manifeste zu identifizieren, die Ihren Aktualisierungsschwellenwert überschritten haben und veraltet sind. Stellen Sie Alarme für diese Metrik ein, sodass Sie benachrichtigt werden, wenn veraltete Manifeste zugestellt werden. Informationen zu Alarmen finden Sie unter [Alarming on metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) im * CloudWatch Amazon-Benutzerhandbuch*. Wenn Sie einen Alarm erhalten, verwenden Sie `Origin.Age` und, `GetManifest.MediaTailorAge` um festzustellen, ob MediaTailor oder der Ursprung für die Veralterung verantwortlich ist. |
| Origin.Age | Misst, wie lange der Ursprung über das Manifest verfügt, bevor es an MediaTailor diese Konfiguration gesendet wird.Diese Metrik wird nicht ausgegeben, wenn die Antwort von einem Content Delivery Network (CDN) kommt. Die Antwort muss vom Ursprung kommen, damit `Origin.Age` sie gesendet werden kann. | Wenn Sie veraltete Manifeste mit identifizieren`GetManifest.Age`, können Sie die `Origin.Age` Metrik und die `GetManifest.MediaTailorAge` Metrik analysieren, um festzustellen, was zur manifesten Veralterung beiträgt. Wenn Sie feststellen, dass dies länger `Origin.Age` ist als Ihre typischen Verarbeitungszeiten am Ursprung, ist es wahrscheinlich, dass das Problem vom vorgelagerten System verursacht wird, und Sie sollten die Diagnose darauf konzentrieren. |
| GetManifest.MediaTailorAge | Misst, wie MediaTailor lange dieses Manifest für diese Konfiguration gespeichert wurde. | Wenn Sie veraltete Manifeste mit identifizieren`GetManifest.Age`, können Sie die `GetManifest.MediaTailorAge` Metrik und die `Origin.Age` Metrik analysieren, um festzustellen, was zur manifesten Veralterung beiträgt. Wenn das länger `GetManifest.MediaTailorAge` dauert als die typische Personalisierung von Manifesten, ist es wahrscheinlich MediaTailor, dass das Problem dadurch verursacht MediaTailor wird, und Sie sollten die Diagnose darauf konzentrieren. `GetManifest.Latency`kann außerdem ermitteln, wie lange es dauert, ein personalisiertes Manifest MediaTailor zu erstellen. |
| GetManifest.Latency | Misst die Zeit, die benötigt wird MediaTailor , um die Anfrage zu bearbeiten und ein personalisiertes Manifest für diese Konfiguration zu erstellen. | Wenn Sie vergleichen `Origin.Age` `GetManifest.MediaTailorAge` und feststellen, dass dies die Ursache für die verzögerte Manifestzustellung MediaTailor ist, können Sie die `GetManifest.Latency` Metrik analysieren, um festzustellen, ob der Prozess der Manifest-Personalisierung zur Veralterung des Manifests beiträgt. `GetManifest.MediaTailorAge`misst die Gesamtzeit, in der das Manifest gespeichert ist. MediaTailor `GetManifest.Latency`misst, wie viel von dieser Speicherzeit auf die MediaTailor Personalisierung des Manifests als Antwort auf eine Anfrage entfällt. |
# AWS Elemental MediaTailor API-Aufrufe aufzeichnen
AWS Elemental MediaTailor ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die ein Benutzer, eine Rolle oder ein AWS Dienst in ausgeführt hat MediaTailor. CloudTrail erfasst alle API-Aufrufe MediaTailor als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der MediaTailor Konsole und Codeaufrufen für die MediaTailor API-Operationen. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Bereitstellung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für MediaTailor. 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 MediaTailor, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details.
Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## AWS Elemental MediaTailor Informationen in CloudTrail
CloudTrail ist in Ihrem AWS Konto aktiviert, wenn Sie das Konto erstellen. Wenn eine Aktivität in stattfindet AWS Elemental MediaTailor, 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 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 AWS Elemental MediaTailor, erstellen Sie einen Trail. Ein *Trail* ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole erstellen, gilt der Trail standardmäßig für alle AWS Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3 S3-Bucket. Darüber hinaus können Sie andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier:
+ [Einen Trail für dein AWS Konto erstellen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [AWS Serviceintegrationen mit Protokollen CloudTrail ](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/configure-sns-notifications-for-cloudtrail.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 AWS Elemental MediaTailor Aktionen werden von der [AWS Elemental MediaTailor API-Referenz](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html) protokolliert CloudTrail und sind in dieser dokumentiert. Zum Beispiel werden durch Aufrufe der `PutPlaybackConfiguration`- und `ListPlaybackConfigurations`-Operationen Einträge in den CloudTrail-Protokolldateien generiert.
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 Anfrage mit den Root-Benutzer- oder AWS Identity and Access Management (IAM-) Anmeldeinformationen gestellt wurde
+ Ob die Anfrage mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen föderierten Benutzer ausgeführt wurde
+ Ob die Anfrage von einem anderen AWS Dienst gestellt wurde
Weitere Informationen finden Sie unter [CloudTrail -Element userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Grundlegendes zu AWS Elemental MediaTailor Einträgen in Protokolldateien
Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis ist eine einzelne Anforderung aus einer beliebigen Quelle und enthält Informationen zur angeforderten Aktion, zu Datum und Uhrzeit der Aktion, zu den Anforderungsparametern usw. CloudTrail -Protokolldateien stellen kein geordnetes Stack-Trace der öffentlichen API-Aufrufe dar. Daher werden sie nicht in einer bestimmten Reihenfolge angezeigt.
Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die `PutPlaybackConfiguration` Aktion demonstriert:
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:53:46Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "PutPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename",
"AdDecisionServerUrl": "http://exampleads.com"
},
"responseElements": {
"SessionInitializationEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/session/AKIAIOSFODNN7EXAMPLE/examplename/",
"DashConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/examplename/",
"MpdLocation": "EMT_DEFAULT"
},
"AdDecisionServerUrl": "http://exampleads.com",
"CdnConfiguration": {},
"PlaybackEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com",
"HlsConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/examplename/"
},
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename"
},
"requestID": "1a2b3c4d-1234-5678-1234-1a2b3c4d5e6f",
"eventID": "987abc65-1a2b-3c4d-5d6e-987abc654def",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die `GetPlaybackConfiguration` Aktion demonstriert:
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:52:37Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "GetPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"Name": "examplename"
},
"responseElements": null,
"requestID": "0z1y2x3w-0123-4567-9876-6q7r8s9t0u1v",
"eventID": "888ddd77-3322-eeww-uuii-abc123jkl343",
"readOnly": true,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
# Empfangen von Benachrichtigungen zur AWS Elemental MediaTailor Kanalmontage
MediaTailor erstellt Warnmeldungen für Probleme oder potenzielle Probleme, die mit Ihren Ressourcen für die Kanalmontage auftreten. Die Warnung beschreibt das Problem, wann das Problem aufgetreten ist und welche Ressourcen betroffen sind.
Sie können die Warnungen in der AWS-Managementkonsole, AWS Command Line Interface (AWS CLI) oder programmgesteuert mithilfe der MediaTailor [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API anzeigen. AWS SDKs
**Wichtig**
Benachrichtigungen sind nur für Channel-Assembly-Ressourcen verfügbar, die am oder nach dem 14. Juli 2021 erstellt wurden.
**Benachrichtigungen zur Kanalmontage**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/channel-assembly-alerts.html)
## Behebung von Warnmeldungen im Zusammenhang mit Manifesten
Wenn Sie auf manifestbezogene Warnmeldungen wie`UNPARSABLE_MANIFEST`, oder stoßen `VARIANT_DURATION_MISMATCH``TARGET_DURATION_MISMATCH`, überprüfen Sie Folgendes:
1. **Überprüfen Sie die Quellanforderungen**: Stellen Sie sicher, dass Ihr Inhalt die unter beschriebenen Anforderungen erfüllt. [Integration einer Inhaltsquelle für die MediaTailor Anzeigeneinfügung](integrating-origin.md)
1. **Überprüfen Sie die Manifestprotokolle**: Eine detaillierte Analyse von Manifestfehlern und Ereignistypen finden Sie unter[AWS Elemental MediaTailor Beschreibung und Ereignistypen der Manifestprotokolle](log-types.md).
1. **Überprüfen Sie die Fehlercodes**: Eine detaillierte Fehleranalyse finden Sie unter[Problembehebung MediaTailor](troubleshooting.md).
1. Überprüfen Sie das **Manifestformat**: Stellen Sie sicher, dass Ihr Manifest den korrekten Formatspezifikationen für Ihr Streaming-Protokoll (HLS oder DASH) entspricht.
## Benachrichtigungen anzeigen
Sie können Benachrichtigungen für jede Ressource zur MediaTailor Kanalmontage anzeigen. Wenn Sie sich die Benachrichtigungen für Kanäle und Programme ansehen, werden MediaTailor auch alle zugehörigen Ressourcen angezeigt, die im Kanal oder Programm enthalten sind. Wenn Sie sich beispielsweise die Benachrichtigungen für ein bestimmtes Programm ansehen, werden Ihnen auch Benachrichtigungen für den Quellstandort und die VOD-Quellen angezeigt, die das Programm enthält.
Gehen Sie wie folgt vor, um Benachrichtigungen anzuzeigen.
------
#### [ Console ]
**Um Benachrichtigungen in der Konsole anzuzeigen**
1. Öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie die Ressource aus, für die Sie Benachrichtigungen anzeigen möchten.
1. Wählen Sie die Registerkarte „**Benachrichtigungen**“, um die Benachrichtigungen anzuzeigen.
------
#### [ AWS Command Line Interface (AWS CLI) ]
Um Benachrichtigungen für eine Channel-Assembly-Ressource aufzulisten, benötigen Sie den [Amazon-Ressourcennamen (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) der Ressource. Sie können den `describe-resource_type` Befehl in der AWS Command Line Interface (AWS CLI) verwenden, um den ARN der Ressource abzurufen. Führen Sie beispielsweise den Befehl [describe-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/describe-channel.html) aus, um den ARN eines bestimmten Kanals abzurufen:
```
aws mediatailor describe-channel --channel-name MyChannelName
```
Verwenden Sie dann den Befehl [aws mediatailor list-alerts, um die mit der Ressource verknüpften Warnungen](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/list-alerts.html) aufzulisten:
```
aws mediatailor list-alerts --resource-arn arn:aws:mediatailor:region:aws-account-id:resource-type/resource-name
```
------
#### [ API ]
Um Benachrichtigungen für eine Channel-Assembly-Ressource aufzulisten, benötigen Sie den [Amazon-Ressourcennamen (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) der Ressource. Sie können den `DescribeResource` Vorgang in der MediaTailor API verwenden, um den ARN der Ressource abzurufen. Verwenden Sie den [DescribeChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeChannel.html)Vorgang beispielsweise, um den ARN eines bestimmten Kanals abzurufen.
Verwenden Sie dann die [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API, um die Benachrichtigungen für die Ressource aufzulisten.
------
## Umgang mit Warnmeldungen
Wenn eine Warnung auftritt, sehen Sie sich die Warnungen in der AWS-Managementkonsole Alerts API an oder verwenden Sie die AWS Command Line Interface (AWS CLI) AWS SDKs, oder die MediaTailor Alerts API, um die möglichen Ursachen des Problems zu ermitteln.
MediaTailor Löscht die Warnung, nachdem Sie das Problem behoben haben.
# Ressourcen taggen AWS Elemental MediaTailor
Ein *Tag* ist eine Metadaten-Bezeichnung, die Sie einer Ressource zuweisen oder die sie einer AWS AWS Ressource zuweist. Jedes Tag besteht aus einem *Schlüssel* und einem *Wert*. Für Tags, die Sie zuweisen, definieren Sie einen Schlüssel und einen Wert. So können Sie beispielsweise den Schlüssel als `stage` und den Wert für eine Ressource als `test` definieren.
Tags sind für folgende Aktivitäten nützlich:
+ Identifizieren und organisieren Sie Ihre AWS Ressourcen. Viele AWS Dienste unterstützen Tagging, sodass Sie Ressourcen aus verschiedenen Diensten dasselbe Tag zuweisen können, um anzuzeigen, dass die Ressourcen miteinander verknüpft sind. Sie könnten beispielsweise einem AWS Elemental MediaPackage Kanal und Endpunkt dasselbe Tag zuweisen, das Sie einer AWS Elemental MediaTailor Konfiguration zuweisen.
+ Verfolgen Sie Ihre AWS Kosten. Sie aktivieren diese Tags auf dem AWS Fakturierung und Kostenmanagement Dashboard. AWS verwendet die Tags, um Ihre Kosten zu kategorisieren und Ihnen einen monatlichen Kostenverteilungsbericht zu senden. Weitere Informationen finden Sie unter [Use cost allocation tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) (Verwendung von Kostenzuordnungs-Tags) im [AWS Billing -Benutzerhandbuch](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Kontrollieren Sie den Zugriff auf Ihre AWS Ressourcen. Weitere Informationen finden Sie unter [Controlling access using tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) (Zugriffssteuerung mit Tags) im [IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html).
In den folgenden Abschnitten finden Sie weitere Informationen zu Tags für AWS Elemental MediaTailor.
## Unterstützte Ressourcen in AWS Elemental MediaTailor
Die folgenden Ressourcen in AWS Elemental MediaTailor unterstützen Tagging:
+ Kanäle
+ Konfigurationen
+ SourceLocations
+ VodSources
## Tag-Einschränkungen
Die folgenden grundlegenden Einschränkungen gelten für Tags auf AWS Elemental MediaTailor Ressourcen:
+ Die maximale Anzahl der Tags, die Sie einer Ressource zuweisen können – 50.
+ Maximale Schlüssellänge – 128 Unicode-Zeichen.
+ Maximale Wertlänge – 256 Unicode-Zeichen.
+ Valid characters for key and value – a-z, A-Z, 0-9, space, and the following characters: \$1 . : / = \$1 - and @
+ Bei Schlüsseln und Werten wird die Groß-/Kleinschreibung berücksichtigt
+ Verwenden Sie nicht `aws:` als Präfix für den Schlüssel. Dieses Präfix ist für AWS reserviert.
## Verwaltung von Tags in AWS Elemental MediaTailor
Sie legen Tags als Eigenschaften für eine Ressource fest. Sie können Tags über die AWS Elemental MediaTailor API oder die AWS Command Line Interface (AWS CLI) hinzufügen, bearbeiten und löschen. Weitere Informationen finden Sie in der [AWS Elemental MediaTailor -API-Referenz](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html).
# Überwachung von AWS Mediendiensten mit Workflow-Monitor
Der Workflow-Monitor ist ein Tool zur Erkennung, Visualisierung und Überwachung von AWS Medien-Workflows. Der Workflow-Monitor ist in der AWS Konsole und in der API verfügbar. Sie können den Workflow-Monitor verwenden, um visuelle Zuordnungen der Ressourcen Ihres Workflows, sogenannte *Signalzuordnungen*, zu ermitteln und zu erstellen. Sie können CloudWatch Amazon-Alarm- und EventBridge Amazon-Regelvorlagen erstellen und verwalten, um die zugewiesenen Ressourcen zu überwachen. Die von Ihnen erstellten Überwachungsvorlagen werden in bereitstellbare AWS CloudFormation Vorlagen umgewandelt, um Wiederholbarkeit zu gewährleisten. AWS empfohlene Alarmvorlagen bieten vordefinierte Best-Practice-Überwachung.
**Entdecken**
Nutzen Sie Signalkarten, um automatisch miteinander verbundene AWS Ressourcen zu erkennen, die mit Ihrem Medien-Workflow verknüpft sind. Die Erkennung kann bei jeder unterstützten Serviceressource beginnen und erstellt eine end-to-end Zuordnung des Workflows. Signalkarten können als eigenständige Visualisierungstools verwendet oder mit Überwachungsvorlagen erweitert werden.
![\[Komponenten zur Erkennung von Workflow-Monitoren.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/workflowmonitor-discovery.png)
**Monitor**
Sie können benutzerdefinierte CloudWatch Alarm- und EventBridge Regelvorlagen erstellen, um den Zustand und den Status Ihrer Medien-Workflows zu überwachen. Es stehen bewährte Alarmvorlagen für den Import in Ihre Workflow-Monitor-Umgebung zur Verfügung. Sie können die Best-Practice-Alarmvorlagen unverändert verwenden oder sie so bearbeiten, dass sie besser zu Ihrem Arbeitsablauf passen. Alle Vorlagen, die Sie erstellen, werden in CloudFormation Vorlagen für eine wiederholbare Bereitstellung umgewandelt.
![\[Komponenten zur Überwachung des Workflow-Monitors.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/workflowmonitor-monitoring.png)
**Anmerkung**
Für die Verwendung des Workflow-Monitors fallen keine direkten Kosten an. Mit den Ressourcen, die zur Überwachung Ihres Workflows erstellt und verwendet werden, sind jedoch Kosten verbunden.
Wenn die Überwachung bereitgestellt wird, werden Amazon CloudWatch - und EventBridge Amazon-Ressourcen erstellt. Wenn Sie die AWS Managementkonsole verwenden, werden Sie vor der Bereitstellung der Überwachung auf einer Signalkarte darüber informiert, wie viele Ressourcen erstellt werden. Weitere Informationen zur Preisgestaltung finden Sie unter: [CloudWatchPreise](https://aws.amazon.com/cloudwatch/pricing/) und [EventBridge Preisgestaltung](https://aws.amazon.com/eventbridge/pricing/).
Der Workflow-Monitor verwendet AWS CloudFormation Vorlagen für die Bereitstellung der CloudWatch EventBridge Ressourcen. Diese Vorlagen werden in einem Amazon Simple Storage Service-Bucket der Standardklasse gespeichert, der während des Bereitstellungsprozesses von Workflow-Monitor in Ihrem Namen erstellt wird und für den Objektspeicher und Rückruf Gebühren anfallen. Weitere Informationen zur Preisgestaltung finden Sie unter: [Amazon S3 S3-Preise](https://aws.amazon.com/s3/pricing/).
In der Workflow-Monitor-Signalmap für AWS Elemental MediaPackage Kanäle generierte Vorschauen werden vom MediaPackage Origin-Endpunkt aus bereitgestellt und es fallen Gebühren für ausgehende Datenübertragungen an. [Die Preise findest du unter: MediaPackage Preise.](https://aws.amazon.com/mediapackage/pricing/)
## Komponenten des Workflow-Monitors
Der Workflow-Monitor besteht aus vier Hauptkomponenten:
+ CloudWatch Alarmvorlagen — Definieren Sie die Bedingungen, anhand derer Sie die Überwachung durchführen möchten CloudWatch. Sie können Ihre eigenen Alarmvorlagen erstellen oder vordefinierte Vorlagen importieren, die von erstellt wurden AWS. Weitere Informationen finden Sie unter: [CloudWatch Alarmgruppen und Vorlagen zur Überwachung Ihres AWS Medienworkflows](monitor-with-workflow-monitor-configure-alarms.md)
+ EventBridge Regelvorlagen — Definieren Sie, wie Benachrichtigungen EventBridge gesendet werden, wenn ein Alarm ausgelöst wird. Weitere Informationen finden Sie unter: [EventBridge Regelgruppen und Vorlagen zur Überwachung Ihres AWS Medien-Workflows](monitor-with-workflow-monitor-configure-notifications.md)
+ Signalzuordnungen — Verwenden Sie einen automatisierten Prozess, um anhand vorhandener AWS Ressourcen AWS elementare Workflow-Übersichten zu erstellen. Die Signalzuordnungen können verwendet werden, um Ressourcen in Ihrem Workflow zu erkennen und diese Ressourcen zu überwachen. Weitere Informationen finden Sie unter: [Signalkarten des Workflow-Monitors](monitor-with-workflow-monitor-configure-signal-maps.md)
+ Überblick — Auf der Übersichtsseite können Sie den Status mehrerer Signalkarten direkt von einem Standort aus überwachen. Überprüfen Sie Metriken, Protokolle und Alarme für Ihre Workflows. Weitere Informationen finden Sie unter: [Überblick über den Workflow-Monitor](monitor-with-workflow-monitor-operate-overview.md)
## Unterstützte Services
Der Workflow-Monitor unterstützt die automatische Erkennung und Signalzuweisung von Ressourcen, die mit den folgenden Diensten verknüpft sind:
+ AWS Elemental MediaConnect
+ AWS Elemental MediaLive
+ AWS Elemental MediaPackage
+ AWS Elemental MediaTailor
+ Amazon S3
+ Amazon CloudFront
**Topics**
+ [Komponenten des Workflow-Monitors](#monitor-with-workflow-monitor-components)
+ [Unterstützte Services](#monitor-with-workflow-monitor-supported-services)
+ [Workflow-Monitor zur Überwachung von AWS Mediendiensten konfigurieren](monitor-with-workflow-monitor-configure.md)
+ [Verwenden Sie den Workflow-Monitor](monitor-with-workflow-monitor-operate.md)
# Workflow-Monitor zur Überwachung von AWS Mediendiensten konfigurieren
Um den Workflow-Monitor zum ersten Mal einzurichten, erstellen Sie die Alarm- und Ereignisvorlagen und entdecken Signalkarten, die zur Überwachung Ihrer Medien-Workflows verwendet werden. Die folgende Anleitung enthält die erforderlichen Schritte, um IAM-Rollen auf Administrator- und Operator-Ebene einzurichten, Workflow-Monitor-Ressourcen zu erstellen und die Überwachung für Ihre Workflows bereitzustellen.
**Topics**
+ [Erste Schritte mit dem Workflow-Monitor](monitor-with-workflow-monitor-configure-getting-started.md)
+ [Workflow-Monitor-Gruppen und -Vorlagen](monitor-with-workflow-monitor-configure-templates.md)
+ [Signalkarten des Workflow-Monitors](monitor-with-workflow-monitor-configure-signal-maps.md)
+ [Workflow-Monitor-Kontingente](monitor-with-workflow-monitor-configure-quotas.md)
# Erste Schritte mit dem Workflow-Monitor
Die folgenden Schritte bieten einen grundlegenden Überblick über die erstmalige Verwendung von Workflow Monitor.
1. Richten Sie Workflow-Monitor-IAM-Berechtigungen für Rollen auf Administrator- und Operatorebene ein: [IAM-Richtlinien zur Workflow-Überwachung](monitor-with-workflow-monitor-configure-getting-started-IAM.md)
1. Erstellen Sie Alarmvorlagen oder importieren Sie vordefinierte Vorlagen, die erstellt wurden von AWS: [CloudWatch-Alarme](monitor-with-workflow-monitor-configure-alarms.md)
1. Erstellen Sie Benachrichtigungsereignisse, die zugestellt werden von EventBridge: [EventBridge Regeln ](monitor-with-workflow-monitor-configure-notifications.md)
1. Entdecken Sie Signalkarten mithilfe Ihrer vorhandenen AWS Elementarressourcen: [Signalkarten ](monitor-with-workflow-monitor-configure-signal-maps.md)
1. Hängen Sie die Alarmvorlagen und Benachrichtigungsregeln an Ihre Signalkarte an: [Vorlagen anhängen](monitor-with-workflow-monitor-configure-signal-maps-attach.md)
1. Stellen Sie die Vorlagen bereit, um mit der Überwachung der Signalkarte zu beginnen: [Bereitstellung von Vorlagen für die Überwachung](monitor-with-workflow-monitor-configure-deploy.md)
1. Überwachen und überprüfen Sie Ihre Workflow-Monitor-Ressourcen mithilfe des Übersichtsbereichs der AWS Konsole: [-Übersicht](monitor-with-workflow-monitor-operate-overview.md)
![\[Die einzelnen Schritte zur Einrichtung des Workflow-Monitors. Beginnen Sie mit der Erstellung der IAM-Rollen. Als Nächstes erstellen Sie Vorlagen für Alarme und Ereignisse. Suchen Sie als Nächstes nach einer Signalkarte und hängen Sie Ihre Vorlagen an die Karte an. Nachdem einer Signalkarte Vorlagen angehängt wurden, müssen die Vorlagen bereitgestellt werden. Der letzte Schritt ist die Überwachung anhand der Vorlagen und der Übersichtsressourcen.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/workflowmonitor-overview-steps.png)
# Workflow-Monitor (IAM-Richtlinien)
Der Workflow-Monitor interagiert mit mehreren AWS Diensten, um Signalkarten, Builds CloudWatch und EventBridge Ressourcen sowie Vorlagen zu erstellen. CloudFormation Da der Workflow-Monitor mit einer Vielzahl von Diensten interagiert, müssen für diese Dienste spezifische AWS Identity and Access Management (IAM-) Richtlinien zugewiesen werden. In den folgenden Beispielen werden die erforderlichen IAM-Richtlinien sowohl für Administrator- als auch für Operator-IAM-Rollen beschrieben.
## IAM-Richtlinie für Administratoren
Die folgende Beispielrichtlinie bezieht sich auf eine IAM-Richtlinie für den Workflow-Monitor auf Administratorebene. Diese Rolle ermöglicht die Erstellung und Verwaltung von Workflow-Monitor-Ressourcen und der unterstützten Serviceressourcen, die mit Workflow-Monitor interagieren.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:List*",
"cloudwatch:Describe*",
"cloudwatch:Get*",
"cloudwatch:PutAnomalyDetector",
"cloudwatch:PutMetricData",
"cloudwatch:PutMetricAlarm",
"cloudwatch:PutCompositeAlarm",
"cloudwatch:PutDashboard",
"cloudwatch:DeleteAlarms",
"cloudwatch:DeleteAnomalyDetector",
"cloudwatch:DeleteDashboards",
"cloudwatch:TagResource",
"cloudwatch:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudformation:List*",
"cloudformation:Describe*",
"cloudformation:CreateStack",
"cloudformation:UpdateStack",
"cloudformation:DeleteStack",
"cloudformation:TagResource",
"cloudformation:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudfront:List*",
"cloudfront:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ec2:DescribeNetworkInterfaces"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"events:List*",
"events:Describe*",
"events:CreateEventBus",
"events:PutRule",
"events:PutTargets",
"events:EnableRule",
"events:DisableRule",
"events:DeleteRule",
"events:RemoveTargets",
"events:TagResource",
"events:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"logs:Describe*",
"logs:Get*",
"logs:TagLogGroup",
"logs:TagResource",
"logs:UntagLogGroup",
"logs:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediaconnect:List*",
"mediaconnect:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"medialive:*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage:List*",
"mediapackage:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackagev2:List*",
"mediapackagev2:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage-vod:List*",
"mediapackage-vod:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediatailor:List*",
"mediatailor:Describe*",
"mediatailor:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"resource-groups:ListGroups",
"resource-groups:GetGroup",
"resource-groups:GetTags",
"resource-groups:GetGroupQuery",
"resource-groups:GetGroupConfiguration",
"resource-groups:CreateGroup",
"resource-groups:UngroupResources",
"resource-groups:GroupResources",
"resource-groups:DeleteGroup",
"resource-groups:UpdateGroupQuery",
"resource-groups:UpdateGroup",
"resource-groups:Tag",
"resource-groups:Untag"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"s3:*"
],
"Resource": "arn:aws:s3:::workflow-monitor-templates*"
},
{
"Effect": "Allow",
"Action": [
"sns:TagResource",
"sns:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"tag:Get*",
"tag:Describe*",
"tag:TagResources",
"tag:UntagResources"
],
"Resource": "*"
}
]
}
```
------
## IAM-Richtlinie für Betreiber
Die folgende Beispielrichtlinie bezieht sich auf eine IAM-Richtlinie für den Workflow-Monitor auf Operatorebene. Diese Rolle ermöglicht eingeschränkten und schreibgeschützten Zugriff auf die Workflow-Monitor-Ressourcen und die unterstützten Serviceressourcen, die mit dem Workflow-Monitor interagieren.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:List*",
"cloudwatch:Describe*",
"cloudwatch:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudformation:List*",
"cloudformation:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudfront:List*",
"cloudfront:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ec2:DescribeNetworkInterfaces"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"events:List*",
"events:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"logs:Describe*",
"logs:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediaconnect:List*",
"mediaconnect:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"medialive:List*",
"medialive:Get*",
"medialive:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage:List*",
"mediapackage:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackagev2:List*",
"mediapackagev2:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage-vod:List*",
"mediapackage-vod:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediatailor:List*",
"mediatailor:Describe*",
"mediatailor:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": "arn:aws:s3:::workflow-monitor-templates*"
},
{
"Effect": "Allow",
"Action": [
"tag:Get*",
"tag:Describe*"
],
"Resource": "*"
}
]
}
```
------
# Workflow-Monitor-Gruppen und -Vorlagen
Bevor Sie die Workflow-Überwachung in einer Signalmap einsetzen können, müssen Sie die Gruppen und Vorlagen für CloudWatch Alarme und EventBridge Benachrichtigungen erstellen. Die CloudWatch Vorlagen definieren, welche Szenarien und Schwellenwerte verwendet werden, um die Alarme auszulösen. Die EventBridge Vorlagen bestimmen, wie Ihnen diese Alarme gemeldet werden.
Wenn Sie nur Zuordnungen Ihrer verbundenen Ressourcen wünschen und nicht die Funktionen der Monitoring-Vorlagen von Workflow-Monitor verwenden möchten, können Sie Signalzuordnungen auch ohne CloudWatch Vorlagen verwenden. EventBridge Weitere Informationen zur Verwendung von Signalkarten finden Sie unter: [Signalkarten ](monitor-with-workflow-monitor-configure-signal-maps.md)
**Topics**
+ [CloudWatch Alarmgruppen und Vorlagen zur Überwachung Ihres AWS Medienworkflows](monitor-with-workflow-monitor-configure-alarms.md)
+ [EventBridge Regelgruppen und Vorlagen zur Überwachung Ihres AWS Medien-Workflows](monitor-with-workflow-monitor-configure-notifications.md)
# CloudWatch Alarmgruppen und Vorlagen zur Überwachung Ihres AWS Medienworkflows
Mit Workflow-Monitor-Alarmen können Sie vorhandene CloudWatch Messwerte als Grundlage für Alarme für Ihre Signalkarten verwenden. Sie können eine Alarmvorlagengruppe erstellen, um die Alarmtypen zu sortieren und zu klassifizieren, die für Ihren Arbeitsablauf wichtig sind. Innerhalb jeder Alarmvorlagengruppe erstellen Sie Alarmvorlagen mit bestimmten CloudWatch Metriken und Parametern, die Sie überwachen möchten. Sie können Ihre eigenen Alarmvorlagen erstellen oder empfohlene Alarmvorlagen importieren, die von erstellt wurden AWS. Nachdem Sie eine Alarmvorlagengruppe und Alarmvorlagen innerhalb dieser Gruppe erstellt haben, können Sie eine oder mehrere dieser Alarmvorlagengruppen an eine Signalmap anhängen.
Sie müssen zuerst eine Alarmvorlagengruppe erstellen. Nachdem Sie eine Alarmvorlagengruppe erstellt haben, können Sie Ihre eigenen Vorlagen erstellen oder empfohlene Vorlagen verwenden, die von erstellt wurden AWS. Wenn Sie Ihre eigenen Alarmvorlagen erstellen möchten, fahren Sie auf dieser Seite fort. Weitere Informationen zum Importieren von empfohlenen Vorlagen finden Sie unter: [Empfohlene Vorlagen](monitor-with-workflow-monitor-configure-alarms-recommended-templates.md)
In diesem Abschnitt wird die Erstellung von CloudWatch Alarmen mithilfe des Workflow-Monitors behandelt. Weitere Informationen darüber, wie der CloudWatch Service mit Alarmen umgeht, und Einzelheiten zu den Alarmkomponenten finden Sie unter: [Verwenden von CloudWatch Alarmen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) im * CloudWatch Amazon-Benutzerhandbuch*
## Alarm-Vorlagengruppen erstellen
Mithilfe von Alarmvorlagengruppen können Sie die Alarmtypen sortieren und klassifizieren, die für Ihren Arbeitsablauf wichtig sind.
**Um eine Alarmvorlagengruppe zu erstellen**
1. Wählen Sie im Navigationsbereich der Workflow-Monitor-Konsole die Option **CloudWatchAlarmvorlagen** aus.
1. Wählen Sie **Alarmvorlagengruppe erstellen** aus.
1. Geben Sie der Alarmvorlagengruppe einen eindeutigen **Gruppennamen** und optional eine **Beschreibung**.
1. Wählen Sie **Erstellen** aus. Sie werden zur Detailseite der neu erstellten Alarmvorlagengruppe weitergeleitet.
## Alarmvorlagen erstellen
Sie können Alarmvorlagen mit den CloudWatch Metriken und Parametern erstellen, die Sie überwachen möchten.
**Um eine Alarmvorlage zu erstellen**
1. Wählen Sie auf der Detailseite der Alarmvorlagengruppe die Option **Alarmvorlage erstellen** aus.
1. Geben Sie der Alarmvorlage einen eindeutigen **Vorlagennamen** und optional eine **Beschreibung**.
1. Gehen **Sie im Abschnitt Metrik auswählen** wie folgt vor:
1. Wählen Sie einen **Zielressourcentyp** aus. Der Zielressourcentyp ist eine Ressource für den jeweiligen Service, z. B. ein Kanal für MediaLive und MediaPackage oder ein Flow für MediaConnect.
1. Wählen Sie einen **Metriknamen** aus. Dies ist die CloudWatch Metrik, die als Grundlage für den Alarm dient. Die Liste der Metriken ändert sich je nach ausgewähltem **Zielressourcentyp**.
1. Gehen Sie im Bereich **Alarmeinstellungen** wie folgt vor:
**Anmerkung**
Weitere Informationen darüber, wie der CloudWatch Service mit Alarmen umgeht, und Einzelheiten zu den Alarmkomponenten finden Sie unter: [Verwenden von CloudWatch Alarmen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) im * CloudWatch Amazon-Benutzerhandbuch*
1. Wählen Sie die **Statistik** aus. Dies ist ein Wert, z. B. eine **Summe** oder ein **Durchschnitt**, der zur Überwachung der Metrik verwendet wird.
1. Wählen Sie den **Vergleichsoperator** aus. Dieses Feld verweist auf den **Schwellenwert**, den Sie im nächsten Schritt festgelegt haben.
1. Legen Sie einen **Schwellenwert** fest. Dies ist ein numerischer Wert, anhand **dessen der Vergleichsoperator** bestimmt, ob der Status größer als, kleiner oder gleich dem Status ist.
1. Legen Sie einen **Zeitraum** fest. Dies ist ein Zeitwert in Sekunden. Der **Zeitraum** ist der Zeitraum, in dem **Statistik**, **Vergleichsoperator** und **Schwellenwert** interagieren, um zu bestimmen, ob der Alarm ausgelöst wird.
1. Legen Sie die **Datenpunkte** fest. Dieser Wert bestimmt, wie viele Datenpunkte benötigt werden, um den Alarm auszulösen.
1. Wählen Sie aus, wie **fehlende Daten behandelt werden sollen**. Diese Auswahl bestimmt, wie dieser Alarm auf fehlende Daten reagiert.
1. Wählen Sie **Erstellen** aus, um den Vorgang abzuschließen.
Ein Beispiel für eine fertige Alarmvorlage könnte die folgenden Parameter haben: Ein MediaConnect **Flow-Zielressourcentyp** wird auf den **Metriknamen** für Verbindungsabbrüche überwacht. Der **Statistikwert** ist auf Summe mit einem **Vergleichsoperator** von „größer als oder gleich“ und einem **Schwellenwert** von 10 festgelegt. Der **Zeitraum** ist auf 60 Sekunden festgelegt und erfordert nur 1 von 1 **Datenpunkten**. **Fehlende Daten behandeln** ist auf „Ignorieren“ gesetzt.
Das Ergebnis dieser Einstellungen ist: Der Workflow-Monitor überwacht, ob es im Flow zu Verbindungsabbrüchen kommt. Wenn innerhalb von 60 Sekunden 10 oder mehr Verbindungsabbrüche auftreten, wird der Alarm ausgelöst. 10 oder mehr Verbindungsabbrüche innerhalb von 60 Sekunden müssen nur einmal geschehen, damit der Alarm ausgelöst wird.
# Empfohlene Alarmvorlagen für die Überwachung Ihres Medienworkflows AWS
Bei den empfohlenen Vorlagen von Workflow Monitor handelt es sich um eine kuratierte Auswahl von AWS Elemental-Servicemetriken mit vordefinierten Alarmeinstellungen, die für die Metrik geeignet sind. Wenn Sie keine benutzerdefinierten Alarmvorlagen erstellen möchten, bieten Ihnen die empfohlenen Vorlagen Best-Practice-Überwachungsvorlagen, die von erstellt wurden. AWS
Der Workflow-Monitor enthält empfohlene Vorlagengruppen für jeden unterstützten Dienst. Diese Gruppen sind so konzipiert, dass sie die Überwachung nach bewährten Methoden auf bestimmte Arten von Workflows anwenden. Jede Vorlagengruppe enthält eine kuratierte Auswahl von Alarmen, die anhand dienstspezifischer Metriken konfiguriert wurden. Beispielsweise hat eine empfohlene Vorlagengruppe für einen MediaLive Multiplex-Workflow einen anderen Satz vorkonfigurierter Metriken als ein CDI-Workflow. MediaConnect
**Um empfohlene Alarmvorlagen zu verwenden**
1. Folgen Sie den Schritten, um [eine Alarmvorlagengruppe zu erstellen](monitor-with-workflow-monitor-configure-alarms.md#monitor-with-workflow-monitor-alarms-groups-create), oder wählen Sie eine bestehende aus.
1. Wählen Sie im Abschnitt **Alarmvorlagen** die Option **Importieren** aus. Sie müssen die AWS empfohlenen Vorlagen in Ihre Vorlagengruppe importieren.
1. Verwenden Sie das Drop-down-Menü **für CloudWatch Alarmvorlagengruppen**, um eine AWS empfohlene Gruppe auszuwählen. Diese Gruppen enthalten kuratierte Alarme für bestimmte Dienste.
1. Wählen Sie mithilfe der Kontrollkästchen die Vorlagen aus, die importiert werden sollen. Jede Vorlage listet ihre Metriken und vorkonfigurierten Überwachungswerte auf und bietet eine Beschreibung der Metrik. Wenn Sie mit der Auswahl der Vorlagen fertig sind, klicken Sie auf die Schaltfläche **Hinzufügen**.
1. Die ausgewählten Vorlagen werden in den Bereich „Zu **importierende Alarmvorlage (n)**“ verschoben. Überprüfen Sie Ihre Auswahl und wählen Sie **Importieren** aus.
1. Nach Abschluss des Imports werden die ausgewählten Vorlagen der Vorlagengruppe hinzugefügt. Wenn Sie weitere Vorlagen hinzufügen möchten, wiederholen Sie den Importvorgang.
1. Importierte Vorlagen können nach dem Import angepasst werden. Die Alarmeinstellungen können an Ihre Alarmanforderungen angepasst werden.
# EventBridge Regelgruppen und Vorlagen zur Überwachung Ihres AWS Medien-Workflows
CloudWatch verwendet EventBridge Amazon-Regeln zum Senden von Benachrichtigungen. Sie beginnen mit der Erstellung einer Event-Vorlagengruppe. In dieser Vorlagengruppe für Ereignisse erstellen Sie Ereignisvorlagen, die festlegen, unter welchen Bedingungen eine Benachrichtigung ausgelöst wird und wer benachrichtigt wird.
In diesem Abschnitt wird die Erstellung von EventBridge Regeln mithilfe des Workflow-Monitors behandelt. Weitere Informationen darüber, wie der EventBridge Service Regeln verwendet, finden Sie unter: [EventBridge Regeln](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) im * EventBridge Amazon-Benutzerhandbuch*
## Vorlagengruppen für Veranstaltungen erstellen
Mithilfe von Vorlagengruppen für Ereignisse können Sie Ereignisse anhand Ihres Anwendungsfalls sortieren und klassifizieren.
**Um eine Vorlagengruppe für Ereignisse zu erstellen**
1. Wählen Sie im Navigationsbereich der Workflow-Monitor-Konsole **EventBridge Regelvorlagen** aus.
1. Wählen Sie **Ereignisvorlagengruppe erstellen** aus.
1. Geben Sie der Alarmvorlagengruppe einen eindeutigen **Gruppennamen** und optional eine **Beschreibung**.
1. Wählen Sie **Erstellen** aus. Sie werden zur Detailseite der neu erstellten Alarmvorlagengruppe weitergeleitet.
## Event-Vorlagen erstellen
Sie können Benachrichtigungen auf der Grundlage von Ereignisvorlagen senden, die Sie erstellt haben.
**Um eine Event-Vorlage zu erstellen**
1. Wählen Sie auf der Detailseite der Veranstaltungsvorlagengruppe die Option **Eventvorlage erstellen** aus.
1. Geben Sie der Veranstaltungsvorlage einen eindeutigen **Vorlagennamen** und optional eine **Beschreibung**.
1. Gehen Sie im Abschnitt **Regeleinstellungen** wie folgt vor:
1. Wählen Sie einen **Ereignistyp** aus. Bei der Auswahl eines Ereignistyps können Sie zwischen mehreren Ereignissen wählen, die von einem Alarm erstellt wurden, AWS oder die Option **Signal map active auswählen, um einen Alarm** zu verwenden, der mit einer Alarmvorlage erstellt wurde.
1. Wählen Sie einen **Target-Service** aus. Dies bestimmt, wie Sie über dieses Ereignis informiert werden möchten. Sie können Amazon Simple Notification Service oder CloudWatch Protokolle auswählen.
1. Nachdem Sie einen Zieldienst ausgewählt haben, wählen Sie ein **Ziel** aus. Dies ist ein Amazon SNS SNS-Thema oder eine CloudWatch Protokollgruppe, abhängig von Ihrer Zielservice-Auswahl.
1. Wählen Sie **Erstellen** aus, um den Vorgang abzuschließen.
# Signalkarten des Workflow-Monitors
Signalkarten sind visuelle Zuordnungen von AWS Ressourcen in Ihrem Medienworkflow. Sie können den Workflow-Monitor verwenden, um die Signalzuordnungssuche für jeden der unterstützten Ressourcentypen zu starten. Während des Erkennungsprozesses ordnet der Workflow-Monitor automatisch und rekursiv alle verbundenen AWS Ressourcen zu. Nachdem die Signalmap erstellt wurde, können Sie die Workflow-Monitor-Konsole verwenden, um beispielsweise Überwachungsvorlagen bereitzustellen, Metriken anzuzeigen und Details der zugewiesenen Ressourcen anzuzeigen.
**Topics**
+ [Signalkarten für AWS Medien-Workflows erstellen](monitor-with-workflow-monitor-configure-signal-maps-create.md)
+ [Signalkarten von AWS Medien-Workflows anzeigen](monitor-with-workflow-monitor-configure-signal-maps-view.md)
+ [Hinzufügen von Alarm- und Ereignisvorlagen zur Signalübersicht Ihres AWS Medienworkflows](monitor-with-workflow-monitor-configure-signal-maps-attach.md)
+ [Bereitstellung von Vorlagen für die Signallampe Ihres AWS Medienworkflows](monitor-with-workflow-monitor-configure-deploy.md)
+ [Aktualisierung der Signalkarte Ihres AWS Medienworkflows](monitor-with-workflow-monitor-configure-signal-maps-update.md)
+ [Löschen der Signallampe Ihres AWS Medien-Workflows](monitor-with-workflow-monitor-configure-signal-maps-delete.md)
# Signalkarten für AWS Medien-Workflows erstellen
Sie können Workflow-Monitor-Signalzuordnungen verwenden, um eine visuelle Zuordnung aller verbundenen AWS Ressourcen in Ihrem Medien-Workflow zu erstellen.
**Um eine Signalmap zu erstellen**
1. Wählen Sie im Navigationsbereich der Workflow-Monitor-Konsole die Option **Signalzuordnungen** aus.
1. Wählen Sie **Signalkarte erstellen** aus.
1. Geben Sie der Signalmap einen **Namen** und eine **Beschreibung**.
1. Im Abschnitt **Neue Signalkarte entdecken** werden die Ressourcen im aktuellen Konto und in der ausgewählten Region angezeigt. Wählen Sie eine Ressource aus, um mit der Erkennung der Signalkarte zu beginnen. Die ausgewählte Ressource wird der Ausgangspunkt für die Suche sein.
1. Wählen Sie **Erstellen** aus. Warten Sie einen Moment, bis der Entdeckungsprozess abgeschlossen ist. Nach Abschluss des Vorgangs wird Ihnen die neue Signalkarte angezeigt.
**Anmerkung**
In der Workflow-Monitor-Signalmap für AWS Elemental MediaPackage Kanäle generierte Vorschauen werden vom MediaPackage Origin-Endpunkt aus bereitgestellt und es fallen Gebühren für ausgehende Datenübertragungen an. [Die Preise findest du unter: MediaPackage Preise.](https://aws.amazon.com/mediapackage/pricing/)
# Signalkarten von AWS Medien-Workflows anzeigen
Mithilfe der Signalkarten des Workflow-Monitors können Sie sich eine visuelle Zuordnung aller verbundenen AWS Ressourcen in Ihrem Medien-Workflow anzeigen lassen.
**Signalkartenansichten**
Nachdem Sie eine Signalkarte ausgewählt haben, stehen Ihnen zwei Ansichten zur Verfügung, mit denen Sie die Signalkarte überwachen oder konfigurieren können. **Signal-Map überwachen** und **Signal-Map konfigurieren** ist eine kontextsensitive Schaltfläche, die sich oben rechts im Bereich der Signal-Map-Konsole befindet.
Wenn Sie die Signalkarte im Abschnitt **Signalkarten** des Navigationsfensters auswählen, wird Ihre Signalkarte in der Konfigurationsansicht angezeigt. In der Konfigurationsansicht können Sie Änderungen an den Vorlagengruppen vornehmen, die an diese Signalkarte angehängt sind, die angehängten Vorlagen bereitstellen und die grundlegenden Details und Tags der Signalkarte anzeigen.
Wenn Sie die Signalkarte im Abschnitt „**Übersicht**“ des Navigationsfensters auswählen, wird Ihre Signalkarte in der Überwachungsansicht angezeigt. In der Überwachungsansicht werden die CloudWatch Alarme, EventBridge Regeln, Warnungen, Protokolle und Messwerte für diese Signalkarte angezeigt.
Die Ansicht kann jederzeit geändert werden, indem Sie oben rechts auf die Schaltfläche **Signalmap überwachen/konfigurieren** klicken. Für die Konfigurationsansicht sind IAM-Berechtigungen auf Administratorebene erforderlich. Die erforderlichen IAM-Berechtigungen können hier eingesehen werden: [IAM-Richtlinien zur Workflow-Überwachung](monitor-with-workflow-monitor-configure-getting-started-IAM.md)
**In der Signalkarte navigieren**
Eine Signalmap enthält Knoten für jede unterstützte AWS-Ressource, die vom Workflow-Monitor erkannt wurde. Bestimmte Ressourcen, wie MediaLive Kanäle und MediaPackage Endpunkte, können Vorschaubilder des Inhalts anzeigen, sofern Vorschaubilder verfügbar sind.
Wenn Sie einen Ressourcenknoten auswählen und im Dropdownmenü **Aktionen** die Option **Ausgewählte Ressourcendetails anzeigen** auswählen, gelangen Sie zur Detailseite des zugehörigen Dienstes. Wenn Sie beispielsweise einen MediaLive Kanal auswählen und **Ausgewählte Ressourcendetails anzeigen** auswählen, wird die Detailseite der MediaLive Konsole für diesen Kanal geöffnet.
Wenn Sie einen Ressourcenknoten auswählen, wird die Liste der aktiven Alarme nur auf diesen Knoten gefiltert. Wenn Sie im aktiven Alarm den **Ziel-ARN** der Ressource auswählen, werden Sie zur Detailseite des zugehörigen Dienstes weitergeleitet, auf der die ausgewählte Ressource geöffnet ist.
# Hinzufügen von Alarm- und Ereignisvorlagen zur Signalübersicht Ihres AWS Medienworkflows
Nachdem Sie Alarm- und Ereignisvorlagen erstellt haben, müssen Sie diese an eine Signalkarte anhängen. Jede der von Ihnen erstellten Alarm- und Ereignisvorlagen kann an alle erkannten Signalkarten angehängt werden.
**Um Alarm- und Ereignisvorlagen an Ihre Signalkarte anzuhängen**
1. Wählen Sie im Navigationsbereich der Workflow-Monitor-Konsole die Option **Signalzuordnungen** und dann die Signalkarte aus, mit der Sie arbeiten möchten.
1. Wählen Sie oben rechts auf der Signalzuordnungsseite auf der Registerkarte **CloudWatchAlarmvorlagengruppen die Option Alarmvorlagengruppen** **anhängen CloudWatch ** aus.
1. **Wählen Sie in dem neuen Bereich, der geöffnet wird, alle Alarmvorlagengruppen aus, die Sie auf diese Signalzuordnung anwenden möchten, und wählen Sie dann Hinzufügen aus.** Dadurch werden die ausgewählten Alarmvorlagengruppen in den Abschnitt **Angehängte CloudWatch Alarmvorlagengruppen** verschoben.
1. Wenn **Sie Speichern** auswählen, werden Ihre Änderungen gespeichert und Sie kehren zur Signalzuordnungsseite zurück.
1. Wählen Sie rechts auf der Signalzuordnungsseite die Registerkarte **EventBridge Regelvorlagengruppen** und dann ** EventBridgeRegelvorlagengruppen anhängen** aus.
1. Wählen Sie im neuen Bereich, der geöffnet wird, alle Event-Vorlagengruppen aus, die Sie auf diese Signalmap anwenden möchten, und wählen Sie dann **Hinzufügen** aus. Dadurch werden die ausgewählten Regelvorlagengruppen in den Abschnitt **Angehängte EventBridge Regelvorlagengruppen** verschoben.
1. Wenn **Sie Speichern** auswählen, werden Ihre Änderungen gespeichert und Sie kehren zur Signalzuordnungsseite zurück.
1. Sie haben der Signalkarte CloudWatch Alarm- und EventBridge Regelvorlagen zugewiesen, aber die Überwachung ist noch nicht implementiert. Im nächsten Abschnitt wird der Einsatz der Überwachungsressourcen behandelt.
# Bereitstellung von Vorlagen für die Signallampe Ihres AWS Medienworkflows
Nachdem Sie die Alarm- und Ereignisvorlagen an Ihre Signalkarte angehängt haben, müssen Sie die Überwachung bereitstellen. Bis die Bereitstellung abgeschlossen ist, ist die Überwachung Ihrer Signalkarte nicht aktiv.
Der Workflow-Monitor löst nur Alarme aus, die für die ausgewählte Signallampe relevant sind. Beispielsweise kann die angehängte Alarmvorlagengruppe Alarme für mehrere Dienste enthalten, z. B. MediaLive MediaPackage, und MediaConnect. Wenn die ausgewählte Signalzuordnung nur MediaLive Ressourcen enthält, werden keine MediaPackage MediaConnect Alarme ausgelöst.
**Um die Überwachungsvorlagen bereitzustellen**
1. Nachdem Sie Ihrer Signalübersicht Gruppen mit Alarm- und Ereignisvorlagen hinzugefügt und Ihre Änderungen gespeichert haben, wählen Sie im Dropdownmenü **Aktionen** die Option **Monitor bereitstellen** aus.
1. Sie werden aufgefordert, die Bereitstellung zu bestätigen, und es werden die Anzahl CloudWatch und die EventBridge Ressourcen angezeigt, die erstellt werden sollen. Wenn Sie fortfahren möchten, wählen Sie **Bereitstellen** aus.
**Anmerkung**
Für die Nutzung des Workflow-Monitors fallen keine direkten Kosten an. Mit den Ressourcen, die zur Überwachung Ihres Workflows erstellt und verwendet werden, sind jedoch Kosten verbunden.
Wenn die Überwachung bereitgestellt wird, werden Amazon CloudWatch - und EventBridge Amazon-Ressourcen erstellt. Wenn Sie die AWS Managementkonsole verwenden, werden Sie vor der Bereitstellung der Überwachung auf einer Signalkarte darüber informiert, wie viele Ressourcen erstellt werden. Weitere Informationen zur Preisgestaltung finden Sie unter: [CloudWatchPreise](https://aws.amazon.com/cloudwatch/pricing/) und [EventBridge Preisgestaltung](https://aws.amazon.com/eventbridge/pricing/).
Der Workflow-Monitor verwendet AWS CloudFormation Vorlagen für die Bereitstellung der CloudWatch EventBridge Ressourcen. Diese Vorlagen werden in einem Amazon Simple Storage Service-Bucket der Standardklasse gespeichert, der während des Bereitstellungsprozesses von Workflow-Monitor in Ihrem Namen erstellt wird und für den Objektspeicher und Rückruf Gebühren anfallen. Weitere Informationen zur Preisgestaltung finden Sie unter: [Amazon S3 S3-Preise](https://aws.amazon.com/s3/pricing/).
1. Der Status der Bereitstellung wird neben dem Namen der Signalkarte angezeigt. Der Bereitstellungsstatus ist auch im Bereich **Stacks** der CloudFormation Konsole sichtbar. Nach einigen Augenblicken der Erstellung und Bereitstellung der Ressourcen beginnt die Überwachung Ihrer Signalkarte.
# Aktualisierung der Signalkarte Ihres AWS Medienworkflows
Wenn an Ihrem Arbeitsablauf eine Änderung vorgenommen wird, müssen Sie möglicherweise die Signalkarte erneut ermitteln und die Überwachungsressourcen erneut einsetzen. Der Workflow-Monitor ist ein Visualisierungs- und Überwachungstool, das keine Änderungen an Ihrem Workflow vornehmen kann. Signalkarten stellen eine point-in-time Visualisierung Ihres Workflows dar. Für den Fall, dass Sie Teile Ihres Medien-Workflows hinzufügen, entfernen oder erheblich ändern, empfehlen wir Ihnen, die Signalmap erneut zu entdecken. Wenn Sie mit der Signalmap Monitoring-Ressourcen verknüpft haben, empfehlen wir Ihnen, die Überwachung nach dem Rediscovery-Prozess erneut einzusetzen.
**Um eine Signalkarte wieder zu entdecken**
1. Wählen Sie im Navigationsbereich der Workflow-Monitor-Konsole die Option **Signalzuordnungen** und dann die Signalkarte aus, mit der Sie arbeiten möchten.
1. Stellen Sie sicher, dass Sie sich in der Ansicht **Signalmap konfigurieren** befinden. Weitere Informationen zum Ändern von Ansichten finden Sie unter: [Signalkarten anzeigen ](monitor-with-workflow-monitor-configure-signal-maps-view.md)
1. Wählen Sie oben rechts auf der Signalzuordnungsseite das Dropdownmenü **Aktionen** aus. **Wählen Sie Wiederentdecken aus.**
1. Ihnen wird der Wiederentdeckungsbildschirm angezeigt. Wählen Sie eine Ressource aus, die Teil des Workflows ist, den Sie gerade wiederentdecken. Wählen Sie die Schaltfläche „**Wiederentdecken**“.
1. Die Signalkarte wird gemäß dem aktuellen Arbeitsablauf neu erstellt. Wenn Sie Monitoring-Ressourcen erneut einsetzen müssen, bleiben Sie auf der Seite dieser Signalübersicht. Alle zuvor angehängten Überwachungsvorlagen bleiben angehängt, müssen jedoch erneut bereitgestellt werden.
**Um Überwachungsvorlagen nach einer erneuten Erkennung der Signalmap erneut bereitzustellen**
1. Nach der Wiederentdeckung werden Sie zur aktualisierten Signalkarte weitergeleitet. Um die Überwachungsvorlagen erneut bereitzustellen, wählen Sie im Dropdownmenü **Aktionen** die Option **Monitor bereitstellen** aus.
1. Sie werden aufgefordert, die Bereitstellung zu bestätigen, und es wird die Anzahl der EventBridge Ressourcen angezeigt CloudWatch , die erstellt werden sollen. Wenn Sie fortfahren möchten, wählen Sie **Bereitstellen** aus.
1. Der Status der Bereitstellung wird neben dem Namen der Signalkarte angezeigt. Nach einigen Augenblicken der Erstellung und Bereitstellung der Ressourcen beginnt die Überwachung der Signalkarte.
# Löschen der Signallampe Ihres AWS Medien-Workflows
Wenn Sie eine Signalkarte nicht mehr benötigen, können Sie sie löschen. Wenn Sie Monitoring-Vorlagen auf der Signal-Map bereitgestellt haben, werden Sie beim Löschen aufgefordert, alle CloudWatch EventBridge Ressourcen zu löschen, die auf dieser Signal-Map bereitgestellt wurden. Das Löschen der bereitgestellten Ressourcen hat keine Auswirkungen auf die Vorlagen, mit denen sie erstellt wurden. Durch das Löschen von Ressourcen soll sichergestellt werden, dass Sie nicht über EventBridge Ressourcen verfügen CloudWatch , die bereitgestellt, aber nicht verwendet werden.
**Um eine Signalkarte zu löschen**
1. Wählen Sie im Navigationsbereich der Workflow-Monitor-Konsole die Option **Signalzuordnungen** aus und klicken Sie auf das Optionsfeld neben der Signalmap, die Sie löschen möchten.
1. Wählen Sie die Schaltfläche **Löschen** aus. Sie werden aufgefordert, das Löschen der Monitoring-Ressourcen zu bestätigen. Wählen Sie **Löschen** aus, um mit dem Löschen der Überwachungsressourcen zu beginnen.
1. In der Spalte **Bereitstellung überwachen** wird der aktuelle Status angezeigt. Wenn sich der Status in **DELETE\$1COMPLETE** geändert hat, klicken Sie erneut auf die Schaltfläche **Löschen**.
1. Sie werden aufgefordert, das Löschen der Signalkarte zu bestätigen. Wählen Sie **Löschen**, um fortzufahren und die Signalkarte zu löschen.
# Workflow-Monitor-Kontingente
Der folgende Abschnitt enthält Kontingente für Workflow-Monitor-Ressourcen. Jedes Kontingent wird „pro Konto“ berechnet. Wenn Sie ein Kontingent für Ihr Konto erhöhen müssen, können Sie die [AWS Servicekontingenten-Konsole](https://console.aws.amazon.com/servicequotas/home) verwenden, um eine Erhöhung zu beantragen, sofern in der folgenden Tabelle nichts anderes angegeben ist.
**Kontingente**
| Ressourcentyp | Kontingent |
| --- | --- |
| CloudWatch Gruppen von Alarmvorlagen | 20 |
| CloudWatch Alarm-Vorlagen | 200 |
| EventBridge Gruppen von Regelvorlagen | 20 |
| EventBridge Regelvorlagen | 200 |
| Signalkarten | 30 |
| Signalkarten: CloudWatch Alarmvorlagengruppen, die an eine einzelne Signalkarte angehängt sind | 5Sie können dieses Kontingent nicht erhöhen. |
| Signalzuordnungen: Gruppen von EventBridge Regelvorlagen, die an eine einzelne Signalmap angehängt sind | 5Sie können dieses Kontingent nicht erhöhen. |
# Verwenden Sie den Workflow-Monitor
Verwenden Sie die Bereiche **Übersicht** und **Signalzuordnungen** der Workflow-Monitor-Konsole, um den aktuellen Status der Workflows und alle zugehörigen Alarme, Metriken und Protokolle zu überprüfen.
**Topics**
+ [Überblick über den Workflow-Monitor](monitor-with-workflow-monitor-operate-overview.md)
+ [Übersicht über Protokolle und Metriken für den Workflow-Monitor](monitor-with-workflow-monitor-operate-logs-metrics.md)
+ [Verwendung von Signalkarten im Workflow-Monitor](monitor-with-workflow-monitor-operate-signal-maps.md)
# Überblick über den Workflow-Monitor
Der Bereich „**Übersicht**“ der Workflow-Monitor-Konsole ist ein Dashboard, das at-a-glance Informationen zu Ihren Signalzuordnungen enthält. Im Übersichtsbereich können Sie den aktuellen Status der Überwachung der einzelnen Signalkarten sowie die CloudWatch Metriken und alle zugehörigen CloudWatch Protokolle einsehen. Sie können eine beliebige Signalmap auswählen, um auf die Konsolenseite der Signal Maps zu gelangen.
**Filterung im Überblick**
Mithilfe der **Suchleiste** im Übersichtsbereich können Sie die Liste der Signalzuordnungen anhand kontextsensitiver Einschränkungen filtern. Nachdem Sie die Suchleiste ausgewählt haben, wird Ihnen eine Liste mit **Eigenschaften** angezeigt, nach denen Sie filtern können. Wenn Sie eine Eigenschaft auswählen, werden **Operatoren** wie „Ist gleich“, „Enthält“, „Entspricht nicht“ und „Enthält nicht“ angezeigt. Wenn Sie einen Operator auswählen, wird eine Liste mit Ressourcen aus dem ausgewählten Eigenschaftstyp erstellt. Wenn Sie eine dieser Ressourcen auswählen, werden in der Signalzuordnungsliste nur Signalkarten angezeigt, die der von Ihnen definierten Einschränkung entsprechen.
# Übersicht über Protokolle und Metriken für den Workflow-Monitor
Um CloudWatch Metriken und Protokolle für eine Signal-Map anzuzeigen, wählen Sie das Optionsfeld neben dem Namen der Signal-Map aus. Unter der Liste der Signalzuordnungen wird eine Oberfläche mit Registerkarten für Metriken und Protokolle angezeigt.
**CloudWatch Metriken**
CloudWatch Die Metriken für die ausgewählte Signalmap sind kontextsensitiv und zeigen nur Metriken an, die mit den in diesem Signalkarten-Workflow verwendeten Diensten verknüpft sind. Sie können die Metriktools auf dem Bildschirm verwenden, um die angezeigten Metrikperioden und Zeitbereiche anzupassen.
**CloudWatch Protokolle**
Wenn Sie der Signalkarte eine CloudWatch Protokollgruppe zugeordnet haben, wird diese Gruppe hier angezeigt.
# Verwendung von Signalkarten im Workflow-Monitor
Im **Übersichtsbereich** der Konsole können Sie eine bestimmte Signal-Map auswählen, um weitere Informationen zu dieser Signal-Map und den zugehörigen Monitoring-Ressourcen zu erhalten.
Nachdem Sie eine Signal-Map ausgewählt haben, werden Ihnen die Signal-Map und eine Reihe von Abschnitten mit Tabs angezeigt, die weitere Informationen enthalten:
+ CloudWatch Alarme
+ EventBridge Regeln
+ AWS Elementare Warnmeldungen
+ Kennzahlen
+ Protokolle
+ Grundlegende Einzelheiten
**In der Signalkarte navigieren**
Eine Signalmap enthält Knoten für jede unterstützte AWS-Ressource, die vom Workflow-Monitor erkannt wurde. Bestimmte Ressourcen, wie MediaLive Kanäle und MediaPackage Endpunkte, können Vorschaubilder des Inhalts anzeigen, sofern Vorschaubilder verfügbar sind.
Wenn Sie einen Ressourcenknoten auswählen und im Dropdownmenü **Aktionen** die Option **Ausgewählte Ressourcendetails anzeigen** auswählen, gelangen Sie zur Detailseite des zugehörigen Dienstes. Wenn Sie beispielsweise einen MediaLive Kanal auswählen und **Ausgewählte Ressourcendetails anzeigen** auswählen, wird die Detailseite der MediaLive Konsole für diesen Kanal geöffnet.
Wenn Sie einen Ressourcenknoten auswählen, wird die Liste der aktiven Alarme nur auf diesen Knoten gefiltert. Wenn Sie im aktiven Alarm den **Ziel-ARN** der Ressource auswählen, werden Sie zur Detailseite des zugehörigen Dienstes weitergeleitet, auf der die ausgewählte Ressource geöffnet ist.