Arten von Metriken für Lambda-Funktionen

In diesem Abschnitt werden die Typen von Lambda-Metriken beschrieben, die in der CloudWatch Konsole verfügbar sind.

Aufrufmetriken

Aufrufmetriken sind binäre Indikatoren für das Ergebnis eines Lambda-Funktionsaufrufs. Betrachten Sie diese Metriken mit der Statistik Sum. Wenn die Funktion beispielsweise einen Fehler zurückgibt, sendet Lambda die Errors-Metrik mit dem Wert 1. Um die Anzahl der Funktionsfehler zu erhalten, die jede Minute aufgetreten sind, lassen Sie sich die Sum der Errors-Metrik mit einem Zeitraum von 1 Minute anzeigen.

• Invocations – Die Häufigkeit, mit der Ihr Funktionscode aufgerufen wird, einschließlich erfolgreicher Aufrufe und Aufrufe, die zu einem Funktionsfehler führen. Aufrufe werden nicht aufgezeichnet, wenn die Aufrufanforderung gedrosselt wird oder anderweitig zu einem Aufruffehler führt. Der Wert von Invocations entspricht der Anzahl der fakturierten Anforderungen.

• Errors – Die Anzahl der Aufrufe, die zu einem Funktionsfehler führen. Funktionsfehler schließen Ausnahmen ein, die Ihr Code ausgibt, und Ausnahmen, die die Lambda-Laufzeit ausgibt. Die Laufzeit gibt Fehler für Probleme wie Timeouts und Konfigurationsfehler zurück. Um die Fehlerquote zu berechnen, teilen Sie den Wert von Errors durch den Wert von Invocations. Beachten Sie, dass der Zeitstempel für eine Fehlermetrik widerspiegelt, wann die Funktion aufgerufen wurde, und nicht, wann der Fehler aufgetreten ist.

• DeadLetterErrors – Bei asynchronen Aufrufen die Häufigkeit, mit der Lambda versucht, ein Ereignis an eine Warteschlange für unzustellbare Nachrichten zu senden, was jedoch fehlschlägt. Zustellungsfehler können aufgrund von falsch eingestellten Ressourcen oder Größenbeschränkungen auftreten.

• DestinationDeliveryFailures – Bei asynchronen Aufrufen und unterstützten Zuordnung von Ereignisquellen die Häufigkeit, mit der Lambda versucht, ein Ereignis an ein Ziel zu senden, dies jedoch fehlschlägt. Für die Zuordnung von Ereignisquellen unterstützt Lambda Ziele für Streamquellen (DynamoDB und Kinesis). Zustellungsfehler können aufgrund von Berechtigungsfehlern, falsch konfigurierten Ressourcen oder Größenbeschränkungen auftreten. Fehler können auch dann passieren, wenn Ihre Konfiguration einen nicht unterstützten Zieltyp enthält, z. B. eine Amazon-SQS-FIFO-Warteschlange oder ein Amazon-SNS-FIFO-Thema.

• Throttles – Die Anzahl der Aufruf-Anforderungen, die gedrosselt werden. Wenn alle Funktions-Instances Anforderungen verarbeiten und keine Nebenläufigkeit zum Hochskalieren verfügbar ist, lehnt Lambda zusätzliche Anforderungen mit einem TooManyRequestsException-Fehler ab. Gedrosselte Anforderungen und andere Aufruffehler zählen nicht als Invocations oder Errors.

• OversizedRecordCount: Bei Amazon-DocumentDB-Ereignisquellen die Anzahl von Ereignissen mit einer Größe von mehr als 6 MB, die Ihre Funktion aus Ihrem Change-Stream empfängt. Lambda verwirft die Nachricht und gibt diese Metrik aus.

• ProvisionedConcurrencyInvocations – Gibt an, wie oft Ihr Funktionscode für bereitgestellte Gleichzeitigkeit aufgerufen wird.

• ProvisionedConcurrencySpilloverInvocations – Gibt an, wie oft Ihr Funktionscode für Standard-Gleichzeitigkeit aufgerufen wird, wenn die gesamte bereitgestellte Gleichzeitigkeit verwendet wird.

• RecursiveInvocationsDropped – Gibt an, wie oft Lambda den Aufruf Ihrer Funktion beendet hat, weil festgestellt wurde, dass Ihre Funktion Teil einer unendlichen rekursiven Schleife ist. Die rekursive Schleifenerkennung überwacht, wie oft eine Funktion als Teil einer Kette von Anfragen aufgerufen wird, indem Metadaten nachverfolgt werden, die von supported hinzugefügt wurden. AWS SDKs Standardmäßig lässt Lambda den nächsten Aufruf aus, wenn Ihre Funktion als Teil einer Kette von Anforderungen etwa 16 Mal aufgerufen wird. Wenn Sie die rekursive Schleifenerkennung deaktivieren, wird diese Metrik nicht ausgegeben. Weitere Informationen über dieses Feature finden Sie unter Verwenden Sie die rekursive Lambda-Schleifenerkennung, um Endlosschleifen zu verhindern.

Leistungsmetriken

Performance-Metriken stellen Performance-Details zu einem einzelnen Funktionsaufruf bereit. Die Metrik Duration gibt beispielsweise die Zeit in Millisekunden an, die Ihre Funktion auf die Verarbeitung eines Ereignisses aufwendet. Um einen Eindruck davon zu erhalten, wie schnell Ihre Funktion Ereignisse verarbeitet, können Sie sich diese Metriken mit der Statistik Average oder Max anzeigen lassen.

• Duration – Die Zeit, die Ihr Funktionscode auf die Verarbeitung eines Ereignisses aufwendet. Die fakturierte Dauer für einen Aufruf ist der Wert von Duration, aufgerundet auf die nächste Millisekunde. Duration beinhaltet nicht die Kaltstartzeit.

• PostRuntimeExtensionsDuration – Die kumulative Zeit, die die Laufzeit nach Abschluss des Funktionscodes mit Erweiterungen verbringt.

• IteratorAge – Bei DynamoDB-, Kinesis- und Amazon-DocumentDB-Ereignisquellen das Alter des letzten Datensatzes im Ereignis in Millisekunden. Diese Matrik misst die Zeit zwischen dem Zeitpunkt, zu dem ein Stream den Datensatz empfängt, und dem Zeitpunkt, zu dem die Zuordnung von Ereignisquellen das Ereignis an die Funktion sendet.

• OffsetLag – Bei selbstverwalteten Apache-Kafka- und Amazon Managed Streaming für Apache Kafka (Amazon MSK)-Ereignisquellen, die Versatzdifferenz zwischen dem letzten Datensatz, der in ein Thema geschrieben wurde, und dem letzten Datensatz, den die Konsumentengruppe Ihrer Funktion verarbeitet hat. Ein Kafka-Thema kann zwar mehrere Partitionen haben, diese Metrik misst die Offset-Verzögerung jedoch auf Themenebene.

Duration unterstützt auch Perzentilstatistiken (p). Verwenden Sie Perzentile, um Ausreißerwerte auszuschließen, die Averages- und Maximum-Statistiken verzerren. Die p95-Statistik zeigt beispielsweise die maximale Dauer von 95 % der Aufrufe, ohne die langsamsten 5 %. Weitere Informationen finden Sie unter Perzentile im CloudWatch Amazon-Benutzerhandbuch.

Gleichzeitigkeitsmetriken

Lambda meldet Gleichzeitigkeitsmetriken als aggregierte Anzahl der Instances, die Ereignisse in einer Funktion, Version, Alias oder AWS-Region verarbeiten. Zeigen Sie diese Metriken mit der Statistik Max an, um zu sehen, wie nah Sie an den Grenzwerten für Gleichzeitigkeit sind.

• ConcurrentExecutions – Die Anzahl der Funktionsinstances, die Ereignisse verarbeiten. Wenn diese Zahl das Kontingent für gleichzeitige Ausführungen für die Region oder das Limit reservierter Gleichzeitigkeit für die Funktion erreicht, drosselt Lambda weitere Aufrufanforderungen.

• ProvisionedConcurrentExecutions – Die Anzahl der Funktions-Instances, die Ereignisse für bereitgestellte Gleichzeitigkeit verarbeiten. Für jeden Aufruf eines Alias oder einer Version mit Provisioned Concurrency gibt Lambda die aktuelle Anzahl aus. Wenn Ihre Funktion inaktiv ist oder keine Anfragen empfängt, gibt Lambda diese Metrik nicht aus.

• ProvisionedConcurrencyUtilization – Für eine Version oder einen Alias der Wert von ProvisionedConcurrentExecutions geteilt durch die Gesamtmenge der konfigurierten Gleichzeitigkeit. Wenn Sie beispielsweise für Ihre Funktion eine bereitgestellte Gleichzeitigkeit von 10 konfigurieren und Ihr ProvisionedConcurrentExecutions 7 ist, dann ist Ihr ProvisionedConcurrencyUtilization 0,7.

  Wenn Ihre Funktion inaktiv ist oder keine Anfragen empfängt, gibt Lambda diese Metrik nicht aus, da sie auf ProvisionedConcurrentExecutions basiert. Beachten Sie dies, wenn Sie es ProvisionedConcurrencyUtilization als Grundlage für CloudWatch Alarme verwenden.

• UnreservedConcurrentExecutions – Für eine Region die Anzahl der Ereignisse, die Funktionen ohne reservierte Nebenläufigkeit verarbeiten.

• ClaimedAccountConcurrency – Mit Bezug auf eine Region die Menge an Gleichzeitigkeit, die für On-Demand-Aufrufe nicht verfügbar ist. ClaimedAccountConcurrency entspricht UnreservedConcurrentExecutions plus dem Betrag der zugewiesenen Gleichzeitigkeit (d. h. der gesamten reservierten Gleichzeitigkeit plus der gesamten bereitgestellten Gleichzeitigkeit). Weitere Informationen finden Sie unter Die Metrik ClaimedAccountConcurrency.

Metriken asynchroner Aufrufe

Metriken asynchroner Aufrufe liefern Details zu asynchronen Aufrufen aus Ereignisquellen und direkten Aufrufen. Sie können Schwellenwerte und Alarme festlegen, um Sie über bestimmte Änderungen zu informieren. Zum Beispiel, wenn die Anzahl der Ereignisse, die für die Verarbeitung in die Warteschlange gestellt werden, ungewollt ansteigt (AsyncEventsReceived). Oder wenn ein Ereignis lange auf seine Verarbeitung gewartet hat (AsyncEventAge).

• AsyncEventsReceived – Die Anzahl der Ereignisse, die Lambda erfolgreich zur Verarbeitung in die Warteschlange stellt. Diese Metrik bietet einen Einblick in die Anzahl der Ereignisse, die eine Lambda-Funktion empfängt. Überwachen Sie diese Metrik und stellen Sie Alarme für Schwellenwerte ein, um nach Problemen zu suchen. Zum Beispiel, um eine unerwünschte Anzahl von Ereignissen zu erkennen, die an Lambda gesendet werden, und um schnell Probleme zu diagnostizieren, die auf falsche Auslöser- oder Funktionskonfigurationen zurückzuführen sind. Diskrepanzen zwischen AsyncEventsReceived und Invocations können auf eine unterschiedliche Verarbeitung, verworfene Ereignisse oder einen möglichen Rückstand in der Warteschlange hinweisen.

• AsyncEventAge – Die Zeit zwischen dem erfolgreichen Einstellen des Ereignisses in die Warteschlange durch Lambda und dem Aufruf der Funktion. Der Wert dieser Metrik steigt, wenn Ereignisse aufgrund von Aufruffehlern oder Drosselung erneut versucht werden. Überwachen Sie diese Metrik und legen Sie Alarme für Schwellenwerte für verschiedene Statistiken fest, wenn sich eine Warteschlange immer länger wird. Um einen Anstieg dieser Metrik zu beheben, sehen Sie sich die Errors-Metrik an, um Funktionsfehler zu identifizieren, und die Throttles-Metrik, um Gleichzeitigkeitsprobleme zu identifizieren.

• AsyncEventsDropped – Die Anzahl der Ereignisse, die verworfen werden, ohne die Funktion erfolgreich auszuführen. Wenn Sie eine Warteschlange für unzustellbare Nachrichten oder ein OnFailure-Ziel konfigurieren, werden Ereignisse dorthin gesendet, bevor sie gelöscht werden. Ereignisse werden aus verschiedenen Gründen verworfen. Beispielsweise können Ereignisse das maximale Ereignisalter überschreiten oder die maximale Anzahl von Wiederholungsversuchen ausschöpfen, oder die reservierte Gleichzeitigkeit ist möglicherweise auf 0 gesetzt. Um herauszufinden, warum Ereignisse verworfen werden, sehen Sie sich die Errors-Metrik an, um Funktionsfehler zu identifizieren, und die Throttles-Metrik, um Gleichzeitigkeitsprobleme zu identifizieren.

Metriken zur Zuordnung von Ereignisquellen

Metriken zur Zuordnung von Ereignisquellen bieten Einblicke in das Verarbeitungsverhalten Ihrer Zuordnung von Ereignisquellen. Mithilfe dieser Metriken können Sie den Fluss und den Status von Ereignissen überwachen, einschließlich der Ereignisse, die von Ihrer Zuordnung von Ereignisquellen erfolgreich verarbeitet, gefiltert oder gelöscht wurden.

Sie müssen sich anmelden, um Metriken zu erhalten, die sich auf Zählungen beziehen (PolledEventCount, FilteredOutEventCount, InvokedEventCount, FailedInvokeEventCount, DroppedEventCount, OnFailureDestinationDeliveredEventCount, und DeletedEventCount). Um sich anzumelden, können Sie die Konsole oder die Lambda-API verwenden.

So aktivieren Sie Metriken oder eine Zuordnung von Ereignisquellen (Konsole)

1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

2. Wählen Sie die Funktion, für die Sie Metriken aktivieren möchten.

3. Wählen Sie Konfiguration und anschließend Auslöser aus.

4. Wählen Sie die Zuordnung von Ereignisquellen, für die Sie Metriken aktivieren möchten und wählen Sie dann Bearbeiten.

5. Wählen Sie unter Konfiguration der Zuordnung von Ereignisquellen die Option Metriken aktivieren aus.

6. Wählen Sie Save (Speichern) aus.

Alternativ können Sie Metriken für Ihre Ereignisquellenzuordnung programmgesteuert aktivieren, indem Sie das EventSourceMappingMetricsConfigObjekt in Ihrem. EventSourceMappingConfiguration Der folgende UpdateEventSourceMappingCLI-Befehl aktiviert beispielsweise Metriken für eine Ereignisquellenzuordnung:

aws lambda update-event-source-mapping \
    --uuid a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --metrics-config Metrics=EventCount

Mit der Sum-Statistik können Sie Metriken im Zusammenhang mit der Anzahl der Ereignisse anzeigen.

Warnung

Zuordnung von Lambda-Ereignisquellen verarbeiten jedes Ereignis mindestens einmal und es kann zu einer doppelten Verarbeitung von Datensätzen kommen. Aus diesem Grund können Ereignisse in Metriken, die Ereigniszählungen beinhalten, mehrfach gezählt werden.

• PolledEventCount – Die Anzahl der Ereignisse, die Lambda erfolgreich aus der Ereignisquelle liest. Wenn Lambda nach Ereignissen abfragt, aber eine leere Umfrage erhält (keine neuen Datensätze), gibt Lambda einen Wert von 0 für diese Metrik aus. Verwenden Sie diese Metrik, um zu ermitteln, ob Ihre Zuordnung von Ereignisquellen korrekt nach neuen Ereignissen fragt.

• FilteredOutEventCount – Bei der Zuordnung von Ereignisquellen mit einem Filterkriterium die Anzahl der Ereignisse, die nach diesen Filterkriterien herausgefiltert wurden. Verwenden Sie diese Metrik, um festzustellen, ob Ihre Zuordnung von Ereignisquellen Ereignisse ordnungsgemäß herausfiltert. Für Ereignisse, die den Filterkriterien entsprechen, gibt Lambda eine 0-Metrik aus.

• InvokedEventCount – Die Anzahl der Ereignisse, die Ihre Lambda-Funktion aufgerufen haben. Verwenden Sie diese Metrik, um zu überprüfen, ob Ereignisse Ihre Funktion ordnungsgemäß aufrufen. Wenn ein Ereignis zu einem Funktionsfehler oder einer Drosselung führt, kann InvokedEventCount aufgrund automatischer Wiederholungsversuche mehrfach für dasselbe abgefragte Ereignis zählen.

• FailedInvokeEventCount – Die Anzahl der Ereignisse, mit denen Lambda versucht hat, Ihre Funktion aufzurufen, was jedoch fehlgeschlagen ist. Aufrufe können aus Gründen wie Netzwerkkonfigurationsproblemen, falschen Berechtigungen oder einer gelöschten Lambda-Funktion, Version oder einem Alias fehlschlagen. Wenn für Ihre Zuordnung von Ereignisquellen partielle Batch-Antworten aktiviert sind, enthält FailedInvokeEventCount jedes Ereignis mit einem nicht leeren BatchItemFailures in der Antwort.

  Anmerkung

  Der Zeitstempel für die FailedInvokeEventCount-Metrik steht für das Ende des Funktionsaufrufs. Dieses Verhalten unterscheidet sich von anderen Lambda-Aufruffehlermetriken, die zu Beginn des Funktionsaufrufs mit einem Zeitstempel versehen werden.

• DroppedEventCount – Die Anzahl der Ereignisse, die Lambda aufgrund von Ablauf oder wiederholter Erschöpfung ausgab. Genauer gesagt ist dies die Anzahl der Datensätze, die die von Ihnen konfigurierten Werte für MaximumRecordAgeInSeconds oder MaximumRetryAttempts überschreiten. Wichtig ist, dass dies nicht die Anzahl der Datensätze beinhaltet, die aufgrund einer Überschreitung der Aufbewahrungseinstellungen Ihrer Ereignisquelle ablaufen. Verworfene Ereignisse schließen auch Ereignisse aus, die Sie bei einem Ausfall an ein Ziel senden. Verwenden Sie diese Metrik, um einen zunehmenden Rückstand an Ereignissen zu erkennen.

• OnFailureDestinationDeliveredEventCount – Bei Zuordnungen von Ereignisquellen mit konfiguriertem Ausfallziel, die Anzahl der Ereignisse, die an dieses Ziel gesendet wurden. Verwenden Sie diese Metrik, um Funktionsfehler im Zusammenhang mit Aufrufen von dieser Ereignisquelle zu überwachen. Wenn die Lieferung an das Ziel fehlschlägt, verarbeitet Lambda die Metriken wie folgt:

  • Lambda gibt die OnFailureDestinationDeliveredEventCount-Metrik nicht aus.

  • Für die DestinationDeliveryFailures-Metrik gibt Lambda eine 1 aus.

  • Für die DroppedEventCount-Metrik gibt Lambda eine Zahl aus, die der Anzahl der Ereignisse entspricht, bei denen die Übermittlung fehlgeschlagen ist.

• DeletedEventCount – Die Anzahl der Ereignisse, die Lambda nach der Verarbeitung erfolgreich löscht. Wenn Lambda versucht, ein Ereignis zu löschen, dies jedoch fehlschlägt, gibt Lambda eine 0-Metrik aus. Verwenden Sie diese Metrik, um sicherzustellen, dass erfolgreich verarbeitete Ereignisse aus Ihrer Ereignisquelle gelöscht werden.

Wenn Ihre Zuordnung von Ereignisquellen deaktiviert ist, erhalten Sie keine Metriken zur Zuordnung von Ereignisquellen. Möglicherweise werden Ihnen auch fehlende Metriken angezeigt, wenn CloudWatch die Verfügbarkeit von Lambda beeinträchtigt ist.

Nicht jede Metrik zur Zuordnung von Ereignisquellen ist für jede Ereignisquelle verfügbar. Derzeit sind Metriken zur Zuordnung von Ereignisquellen für Amazon SQS-, Kinesis- und DynamoDB-Streams-Ereignisquellen verfügbar. Die folgende Verfügbarkeitsmatrix fasst die unterstützten Metriken für jede Art von Ereignisquelle zusammen.

Metrik zur Zuordnung von Ereignisquellen	Support für Amazon SQS	Unterstützung für Kinesis- und DynamoDB-Streams
PolledEventCount	Ja	Ja
FilteredOutEventCount	Ja	Ja
InvokedEventCount	Ja	Ja
FailedInvokeEventCount	Ja	Ja
DroppedEventCount	Nein	Ja
OnFailureDestinationDeliveredEventCount	Nein	Ja
DeletedEventCount	Ja	Nein

Wenn sich Ihre Zuordnung von Ereignisquellen im Bereitstellungsmodus befindet, stellt Lambda außerdem die folgende Metrik bereit:

• ProvisionedPollers – Bei Zuordnungen von Ereignisquellen im Bereitstellungsmodus die Anzahl der aktiv laufenden Ereignis-Poller. Zeigen Sie diese Metrik mithilfe der MAX-Metrik an.