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. # Überwachung der Amazon Neptune Neptune-Ressourcen Amazon Neptune unterstützt verschiedene Methoden für die Überwachung der Leistung und Nutzung von Datenbanken: + **Instance-Status** – Überprüfen Sie den Zustand der Graphdatenbank-Engine eines Neptune-Clusters, ermitteln Sie die installierte Version der Engine und rufen Sie über die [Instance-Status-API](access-graph-status.md) weitere Informationen zur Instance ab. + **Diagrammübersicht-API** – Mit der [Diagrammübersicht-API](neptune-graph-summary.md) können Sie schnell eine Übersicht über Größe und Inhalt Ihrer Diagrammdaten erhalten. **Anmerkung** Da die Diagrammübersicht-API [DFE-Statistiken](neptune-dfe-statistics.md) nutzt, ist sie nur verfügbar, wenn Statistiken aktiviert sind, was bei den Instance-Typen T3 und T4g nicht der Fall ist. + **Amazon CloudWatch** — Neptune sendet automatisch Messwerte an Alarme CloudWatch und unterstützt CloudWatch diese auch. Weitere Informationen finden Sie unter [Überwachung von Neptune mit Amazon CloudWatch](cloudwatch.md). + **Audit-Protokolldateien** – Sie können Datenbankprotokolldateien über die Neptune-Konsole anzeigen, herunterladen oder beobachten. Weitere Informationen finden Sie unter [Verwenden von Prüfprotokollen mit Amazon-Neptune-Clustern](auditing.md). + **Protokolle in Amazon CloudWatch Logs** veröffentlichen — Sie können einen Neptune-DB-Cluster so konfigurieren, dass Audit-Protokolldaten in einer Protokollgruppe in Amazon CloudWatch Logs veröffentlicht werden. Mit CloudWatch Logs können Sie die Protokolldaten in Echtzeit analysieren, Alarme erstellen und Metriken anzeigen und CloudWatch Logs verwenden, um Ihre Protokolldatensätze auf einem äußerst dauerhaften Speicher zu speichern. CloudWatch Siehe [Neptun-Logs CloudWatch ](cloudwatch-logs.md). + **AWS CloudTrail**— Neptune unterstützt die API-Protokollierung mithilfe von. CloudTrail Weitere Informationen finden Sie unter [Protokollieren Amazon Neptune Neptune-API-Aufrufen mit AWS CloudTrail](cloudtrail.md). + **Ereignisbenachrichtigungs-Abonnements** – Abonnieren Sie Neptune-Ereignisse, um über das Geschehen auf dem Laufenden zu bleiben. Weitere Informationen finden Sie unter [Verwenden von Neptune-Ereignisbenachrichtigungen](events.md). + **Tagging** – Sie können Tags verwenden, um Ihren Neptune-Ressourcen Metadaten hinzuzufügen und die Nutzung mit Tags nachzuverfolgen. Weitere Informationen finden Sie unter [Taggen von Amazon Neptune Neptune-Ressourcen](tagging.md). **Topics** + [Prüfen des Zustands einer Neptune-Instance](access-graph-status.md) + [Überwachung von Neptune mit Amazon CloudWatch](cloudwatch.md) + [Verwenden von Prüfprotokollen mit Amazon-Neptune-Clustern](auditing.md) + [Neptune Logs auf Amazon Logs veröffentlichen CloudWatch](cloudwatch-logs.md) + [Amazon CloudWatch Logs für ein Neptune-Notizbuch aktivieren](notebook-logs.md) + [Verwenden der Amazon-Neptune-Protokollierung für langsame Abfragen](slow-query-logs.md) + [Protokollieren Amazon Neptune Neptune-API-Aufrufen mit AWS CloudTrail](cloudtrail.md) + [Verwenden von Neptune-Ereignisbenachrichtigungen](events.md) + [Taggen von Amazon Neptune Neptune-Ressourcen](tagging.md) # Prüfen des Zustands einer Neptune-Instance Amazon Neptune stellt einen Mechanismus für die Überprüfung des Status der Graphsatenbank auf dem Host bereit. Auf diesem Wege können Sie auch prüfen, ob Sie sich mit einer Instance verbinden können. Um den Zustand einer Instance zu überprüfen und den DB-Cluster-Status abzurufen, verwenden Sie `curl`: ``` curl -G https://your-neptune-endpoint:port/status ``` Ab [Engine-Version 1.2.1.0.R6](engine-releases-1.2.1.0.R6.md) können Sie stattdessen auch den folgenden CLI-Befehl verwenden: ``` aws neptunedata get-engine-status ``` Wenn die Instance fehlerfrei ist, gibt der `status`-Befehl ein [JSON-Objekt](#access-graph-status-sample-output) mit den folgenden Feldern zurück: + **`status`**   –   Auf `"healthy"` festgelegt, wenn die Instance keine Probleme hat. Wenn die Instance nach einem Ausfall oder Neustart wiederhergestellt wird und weiter aktive Transaktionen vom letzten Herunterfahren des Servers ausgeführt werden, ist `status` auf `"recovery"` festgelegt. + **`startTime`**   –   Auf die UTC-Zeit festgelegt, zu der der aktuelle Serverprozess gestartet wurde. + **`dbEngineVersion`**   –   Auf die Version der Neptune-Engine festgelegt, die im DB-Cluster ausgeführt wird. Wenn diese Engine-Version nach der Veröffentlichung manuell gepatcht wurde, wird der Versionsnummer `"Patch-"` vorangestellt. + **`role`**   –   Auf `"reader"` festgelegt, wenn die Instance eine Read Replica ist, oder auf `"writer"`, wenn die Instance die primäre Instance ist. + **`dfeQueryEngine`**   –   Auf `"enabled"` festgelegt, wenn die [DFE-Engine](neptune-dfe-engine.md) vollständig aktiviert ist, oder auf `viaQueryHint` (Standardwert), wenn die DFE-Engine nur für Abfragen verwendet wird, bei denen der Abfragehinweis `useDFE` auf `true` festgelegt ist (Standardwert ist `viaQueryHint`). + **`gremlin`**   –   Enthält Informationen zur Gremlin-Abfragesprache im Cluster. Insbesondere enthält es ein `version` Feld, das die aktuelle TinkerPop Version angibt, die von der Engine verwendet wird. + **`sparql`**   –   Enthält Informationen zur SPARQL-Abfragesprache im Cluster. Insbesondere ist das Feld `version` enthalten, das die die aktuelle SPARQL-Version angibt, die von der Engine verwendet wird. + **`opencypher`**   –   Enthält Informationen zur openCypher-Abfragesprache im Cluster. Insbesondere ist das Feld `version` enthalten, das die openCypher-Version angibt, die von der Engine verwendet wird. + **`labMode`**   –   Enthält die [Labor-Modus](features-lab-mode.md)-Einstellungen, die von der Engine verwendet werden. Dies ist eine selektive Liste von Labormodus-Einstellungen und nicht der vollständige Satz. Den gesamten verwendeten Satz finden Sie in der [Cluster-Parametergruppe](https://docs.aws.amazon.com//neptune/latest/userguide/parameter-groups.html). + **`rollingBackTrxCount`**   –   Wenn Transaktionen rückgängig gemacht werden, ist dieses Feld auf die Anzahl dieser Transaktionen festgelegt Wenn keine Transaktionen rückgängig gemacht werden, wird das Feld nicht angezeigt. + **`rollingBackTrxEarliestStartTime`**   –   Auf die Startzeit der frühesten Transaktion festgelegt, die rückgängig gemacht wird wird. Wenn keine Transaktionen rückgängig gemacht werden, wird das Feld nicht angezeigt. + **`features`**   –   Enthält Statusinformationen zu den im DB-Cluster aktivierten Funktionen: + **`lookupCache`**   –   Der aktuelle Status für [Nachschlage-Cache](feature-overview-lookup-cache.md). Dieses Feld wird nur für `R5d`-Instance-Typen angezeigt, da dies die einzigen Instances sind, in denen ein Lookup-Cache vorhanden sein kann. Das Feld ist ein JSON-Objekt mit dem Format: ``` "lookupCache": { "status": "current lookup cache status" } ``` Für eine `R5d`-Instance: + Wenn der Lookup-Cache aktiviert ist, wird der Status als `"Available"` aufgelistet. + Wenn der Lookup-Cache deaktiviert ist, wird der Status als `"Disabled"` aufgelistet. + Wenn das Festplattenlimit für die Instance erreicht wurde, wird der Status als `"Read Only Mode - Storage Limit Reached"` aufgelistet. + **`ResultCache`**   –   Der aktuelle Status für [Zwischenspeichern von Abfrageergebnissen](gremlin-results-cache.md). Das Feld ist ein JSON-Objekt mit dem Format: ``` "ResultCache": { "status": "current results cache status" } ``` + Wenn der Ergebnis-Cache aktiviert wurde, wird der Status als `"Available"` aufgelistet. + Wenn der Cache deaktiviert ist, wird der Status als `"Disabled"` aufgelistet. + **`IAMAuthentication`**— Gibt an, ob die AWS Identity and Access Management (IAM-) Authentifizierung in Ihrem DB-Cluster aktiviert wurde oder nicht: + Wenn die IAM-Authentifizierung aktiviert ist, wird der Status als `"enabled"` aufgelistet. + Wenn die IAM-Authentifizierung deaktiviert ist, wird der Status als `"disabled"` aufgelistet. + **`Streams`**   –   Gibt an, ob für den DB-Cluster Neptune-Streams aktiviert sind oder nicht: + Wenn Streams aktiviert sind, wird der Status als `"enabled"` aufgelistet. + Wenn Streams deaktiviert sind, wird der Status als `"disabled"` aufgelistet. + **`AuditLog`**   –   Gleich `enabled`, wenn Audit-Logs aktiviert sind, andernfalls `disabled`. + **`SlowQueryLogs`**   –   Gleich `info` oder `debug`, wenn die [Protokollierung für langsame Abfragen](slow-query-logs.md) aktiviert ist, andernfalls `disabled`. + **`QueryTimeout`**   –   Der Wert des Abfrage-Timeouts in Millisekunden. + **`settings`**   –   Auf die Instance angewendete Einstellungen: + **`clusterQueryTimeoutInMs`**   –   Der Wert des Abfrage-Timeouts in Millisekunden, der für den gesamten Cluster festgelegt wurde. + **`SlowQueryLogsThreshold`**   –   Der Wert des Abfrage-Timeouts in Millisekunden, der für den gesamten Cluster festgelegt wurde. + **`serverlessConfiguration`**   –   Serverless-Einstellungen für einen Cluster, wenn er als Serverless-Cluster ausgeführt wird: + **`minCapacity`**— Die kleinste Größe, auf die eine serverlose Instance in Ihrem DB-Cluster schrumpfen kann, in Neptune Capacity Units (). NCUs + **`maxCapacity`**— Die größte Größe, auf die eine serverlose Instance in Ihrem DB-Cluster anwachsen kann, in Neptune-Kapazitätseinheiten (). NCUs ## Beispielausgabe des Befehls instanzstatus Dies ist ein Beispiel für die Ausgabe des Instance-Status-Befehls (in diesem Fall für eine `R5d`-Instance): ``` { 'status': 'healthy', 'startTime': 'Thu Aug 24 21:47:12 UTC 2023', 'dbEngineVersion': '1.2.1.0.R4', 'role': 'writer', 'dfeQueryEngine': 'viaQueryHint', 'gremlin': {'version': 'tinkerpop-3.6.2'}, 'sparql': {'version': 'sparql-1.1'}, 'opencypher': {'version': 'Neptune-9.0.20190305-1.0'}, 'labMode': { 'ObjectIndex': 'disabled', 'ReadWriteConflictDetection': 'enabled' }, 'features': { 'SlowQueryLogs': 'disabled', 'ResultCache': {'status': 'disabled'}, 'IAMAuthentication': 'disabled', 'Streams': 'disabled', 'AuditLog': 'disabled' }, 'settings': { 'clusterQueryTimeoutInMs': '120000', 'SlowQueryLogsThreshold': '5000' }, 'serverlessConfiguration': { 'minCapacity': '1.0', 'maxCapacity': '128.0' } } ``` Gibt es ein Problem mit der Instance, gibt der Statusbefehl den Fehlercode `HTTP 500` zurück. Wenn der Host nicht erreichbar ist, kommt es zu einer Zeitüberschreitung der Anforderung. Stellen Sie sicher, dass Sie über die Virtual Private Cloud (VPC) auf die Instance zugreifen und dass Ihre Sicherheitsgruppen Ihnen Zugriff darauf gewähren. # Überwachung von Neptune mit Amazon CloudWatch Amazon Neptune und Amazon CloudWatch sind integriert, sodass Sie Leistungskennzahlen sammeln und analysieren können. Sie können diese Metriken mithilfe der CloudWatch Konsole, der AWS Command Line Interface (AWS CLI) oder der CloudWatch API überwachen. CloudWatch ermöglicht es Ihnen auch, Alarme einzustellen, sodass Sie benachrichtigt werden können, wenn ein Metrikwert einen von Ihnen angegebenen Schwellenwert überschreitet. Sie können sogar CloudWatch Ereignisse einrichten, um im Falle eines Verstoßes Korrekturmaßnahmen zu ergreifen. Weitere Informationen zur Verwendung CloudWatch und zu Alarmen finden Sie in der [CloudWatch Dokumentation](https://aws.amazon.com/documentation/cloudwatch). **Topics** + [CloudWatch Daten anzeigen (Konsole)](#Console_Neptune) + [CloudWatch Daten anzeigen (AWS CLI)](#CloudwatchCLI_Neptune) + [CloudWatch Daten anzeigen (API)](#CloudwatchAPI_Neptune) + [Wird verwendet CloudWatch , um die Leistung der DB-Instance in Neptune zu überwachen](cloudwatch-monitoring-instances.md) + [Neptun-Metriken CloudWatch](cw-metrics.md) + [CloudWatch Neptun-Dimensionen](cw-dimensions.md) ## CloudWatch Daten anzeigen (Konsole) **So zeigen Sie CloudWatch Daten für einen Neptun-Cluster an (Konsole)** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 1. Wählen Sie im Navigationsbereich **Metriken** aus. 1. **Wählen Sie im Bereich **Alle Metriken** **Neptune** und dann Identifier ausDBCluster.** 1. Führen Sie im oberen Bereich einen Bildlauf nach unten durch, um die vollständige Liste der Metriken für Ihren Cluster anzuzeigen. Die verfügbaren Neptune-Metrikoptionen erscheinen in der Liste **Angezeigt**. Um eine einzelne Metrik im Ergebnisbereich aus- oder abzuwählen, aktivieren Sie das Kontrollkästchen neben dem Ressourcennamen und der Metrik. Am unteren Rand der Konsole werden Diagramme mit den Metriken für die ausgewählten Elemente angezeigt. Weitere Informationen zu CloudWatch Diagrammen finden Sie unter [Graph Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/graph_metrics.html) im * CloudWatch Amazon-Benutzerhandbuch*. ## CloudWatch Daten anzeigen (AWS CLI) **Um CloudWatch Daten für einen Neptun-Cluster anzuzeigen ()AWS CLI** 1. Installieren Sie das. AWS CLI Anweisungen finden Sie im [AWS Command Line Interface -Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). 1. Verwenden Sie den AWS CLI , um Informationen abzurufen. Die relevanten CloudWatch Parameter für Neptune sind unter aufgeführt. [Neptun-Metriken CloudWatch](cw-metrics.md) Im folgenden Beispiel werden CloudWatch Metriken für die Anzahl der Gremlin-Anfragen pro Sekunde für den Cluster abgerufen. `gremlin-cluster` ``` ``` ## CloudWatch Daten anzeigen (API) CloudWatch unterstützt auch eine `Query` Aktion, sodass Sie Informationen programmgesteuert anfordern können. Weitere Informationen finden Sie in der [CloudWatch Query API-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/Using_Query_API.html) und in der [Amazon CloudWatch API-Referenz](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/). Wenn für eine CloudWatch Aktion ein Parameter erforderlich ist, der spezifisch für die Neptun-Überwachung ist`MetricName`, verwenden Sie z. B. die unter aufgeführten Werte. [Neptun-Metriken CloudWatch](cw-metrics.md) Das folgende Beispiel zeigt eine CloudWatch Anfrage auf niedriger Ebene, bei der die folgenden Parameter verwendet werden: + `Statistics.member.1` = `Average` + `Dimensions.member.1` = `DBClusterIdentifier=gremlin-cluster` + `Namespace ` = `AWS/Neptune` + `StartTime ` = `2013-11-14T00:00:00Z` + `EndTime ` = `2013-11-16T00:00:00Z` + `Period ` = `60` + `MetricName ` = `GremlinRequestsPerSec` So sieht die CloudWatch Anfrage aus. Dies ist jedoch nur eine Veranschaulichung der Form der Anforderung. Sie müssen Ihre eigene Anforderung basierend auf Ihren Metriken und Ihrem Zeitrahmen erstellen. ``` 1. https://monitoring.amazonaws.com/ 2. ?SignatureVersion=2 3. &Action=GremlinRequestsPerSec 4. &Version=2010-08-01 5. &StartTime=2018-03-03T00:00:00 6. &EndTime=2018-03-04T00:00:00 7. &Period=60 8. &Statistics.member.1=Average 9. &Dimensions.member.1=DBClusterIdentifier=gremlin-cluster 10. &Namespace=AWS/Neptune 11. &MetricName=GremlinRequests 12. &Timestamp=2018-03-04T17%3A48%3A21.746Z 13. &AWSAccessKeyId=AWS Access Key ID; 14. &Signature=signature ``` # Wird verwendet CloudWatch , um die Leistung der DB-Instance in Neptune zu überwachen Sie können CloudWatch Metriken in Neptune verwenden, um zu überwachen, was auf Ihren DB-Instances passiert, und die von der Datenbank beobachtete Länge der Abfragewarteschlange verfolgen. Die folgenden Metriken sind besonders nützlich: + **`CPUUtilization`**   –   Zeigt den Prozentsatz der CPU-Auslastung an. + **`VolumeWriteIOPs`**— Zeigt die durchschnittliche Anzahl von I/O Schreibvorgängen auf das Cluster-Volume auf der Festplatte an, die in Intervallen von 5 Minuten gemeldet wird. + **`MainRequestQueuePendingRequests`**   –   Zeigt die Anzahl der Anforderungen in der Eingabewarteschlange an, deren Ausführung aussteht. Sie können auch feststellen, wie viele Anforderungen auf dem Server ausstehen, indem Sie die [Gremlin-Endpunkt-Statusabfrage](gremlin-api-status.md) mit dem Parameter `includeWaiting` verwenden. Dadurch erhalten Sie den Status aller wartenden Abfragen. Die folgenden Indikatoren können Ihnen helfen, die Bereitstellungs- und Abfragestrategien für Neptune anzupassen, um Effizienz und Leistung zu verbessern: + Konsistente Latenz, hoch`CPUUtilization`, hoch `VolumeWriteIOPs` und niedrig `MainRequestQueuePendingRequests` zusammen zeigen, dass der Server aktiv damit beschäftigt ist, gleichzeitige Schreibanforderungen mit einer nachhaltigen Geschwindigkeit und mit geringer I/O Wartezeit zu verarbeiten. + Eine konsistente Latenz, niedrige Werte für `CPUUtilization`, niedrige Werte für `VolumeWriteIOPs` und keine `MainRequestQueuePendingRequests` zeigen überschüssige Kapazitäten für die Verarbeitung von Schreibanforderungen auf der primären DB-Instance an. + Eine variable Latenz, hohe Werte für `CPUUtilization` und `VolumeWriteIOPs` und keine `MainRequestQueuePendingRequests` zeigen, dass mehr Aufträge gesendet werden, als der Server in einem bestimmten Intervall verarbeiten kann. Erwägen Sie, Batch-Anfragen zu erstellen oder ihre Größe zu ändern, um dieselbe Menge an Arbeit mit weniger Transaktionsaufwand zu erledigen, indem Sie die primäre Instanz and/or skalieren, um die Anzahl der Abfrage-Threads zu erhöhen, die Schreibanforderungen gleichzeitig verarbeiten können. + Niedrig `CPUUtilization` und hoch `VolumeWriteIOPs` bedeuten, dass Abfrage-Threads darauf warten, dass die I/O Operationen auf der Speicherebene abgeschlossen sind. Wenn Sie variable Latenzen und einen Anstieg für `MainRequestQueuePendingRequests` feststellen, sollten Sie die Erstellung oder Änderung von Batch-Anforderungen in Betracht ziehen, um die gleiche Anzahl von Aufträgen mit einem geringeren Transaktionsaufwand auszuführen. # Neptun-Metriken CloudWatch **Anmerkung** Amazon Neptune sendet CloudWatch nur dann Messwerte an, wenn sie einen Wert ungleich Null haben. Die Aggregationsgranularität für alle Neptune-Metriken beträgt 5 Minuten. **Topics** + [Neptun-Metriken CloudWatch](#cw-metrics-available) + [CloudWatch Metriken, die jetzt in Neptune veraltet sind](#cw-metrics-deprecated) ## Neptun-Metriken CloudWatch In der folgenden Tabelle sind die CloudWatch Metriken aufgeführt, die Neptune unterstützt. **Anmerkung** Alle kumulativen Metriken werden bei jedem Serverneustart auf null zurückgesetzt, ob für Wartungsarbeiten, Neustart oder Wiederherstellung nach einem Absturz. **Neptun-Metriken CloudWatch** | Metrik | Description | | --- | --- | | `BackupRetentionPeriodStorageUsed` | Der gesamte Sicherungsspeicher (in Byte), der zur Unterstützung aus dem Sicherungs-Aufbewahrungszeitraum des Neptune-DB-Clusters verwendet wird. Ist in dem von der `TotalBackupStorageBilled`-Metrik gemeldeten Gesamtwert enthalten. | | `BufferCacheHitRatio` | Der Prozentsatz der vom Buffer-Cache bedienten Anfragen. Diese Metrik kann bei der Diagnose der Abfragelatenz nützlich sein, da Cache-Fehler zu einer erheblichen Latenz führen. Wenn die Cache-Trefferquote unter 99,9 % liegt sollten Sie den Instance-Typ heraufstufen um mehr Daten im Arbeitsspeicher zwischenspeichern zu können. | | `ClusterReplicaLag` | Der Verzögerungszeitraum in Millisekunden für ein Read Replica, wenn Updates aus einer primären Instance repliziert werden. | | `ClusterReplicaLagMaximum` | Der größte Verzögerungszeitraum in Millisekunden zwischen der primären Instance und jeder Neptune-DB-Instance im DB-Cluster. | | `ClusterReplicaLagMinimum` | Der kleinste Verzögerungszeitraum in Millisekunden zwischen der primären Instance und jeder Neptune-DB-Instance im DB-Cluster. | | `CPUCreditBalance` | Die Anzahl der in 5-Minuten-Intervallen gemeldeten CPU-Guthaben, die eine Instance angesammelt hat. Sie können diese Metrik verwenden, um zu bestimmen, wie lange eine DB-Instance das normale Leistungslevel bei gegebener Leistungsrate übersteigen kann. | | `CPUCreditUsage` | Die Anzahl der während des angegebenen Zeitraums verwendeten CPU-Guthaben (Meldung in 5-Minuten-Intervallen). Diese Metrik misst den Zeitraum, in dem physische Geräte für die Verarbeitung von Anweisungen von virtuellen Geräten verwendet CPUs wurden, die der DB-Instance CPUs zugewiesen sind. | | `CPUSurplusCreditBalance` | Die Anzahl überzähliger Guthaben, die von einer Unlimited-Instance verbraucht wurden, wenn ihr `CPUCreditBalance`-Wert null ist. Der `CPUSurplusCreditBalance`-Wert wird durch erworbene CPU-Guthaben abgezahlt. Wenn die Anzahl überzähliger Guthaben die Höchstzahl der Guthaben überschreitet, die die Instance in einem 24-Stunden-Zeitraum verdienen kann, fallen für die verbrauchten überzähligen Guthaben zusätzliche Gebühren an. Die Metriken für CPU-Guthaben sind nur mit einer fünfminütigen Frequenz verfügbar. | | `CPUSurplusCreditsCharged` | Die Anzahl der verbrauchten überschüssigen Credits, die nicht durch verdiente CPU-Guthaben zurückgezahlt werden und für die eine zusätzliche Gebühr anfällt. | | `CPUUtilization` | Prozentsatz der CPU-Auslastung. | | `EngineUptime` | Der gesamte Zeitraum der Laufzeit der Instance in Sekunden. | | `FreeableMemory` | Die Menge des verfügbaren Arbeitsspeichers (RAM-Speicher) in Bytes. | | `GlobalDbDataTransferBytes` | Die Anzahl der Byte an Redo-Log-Daten, die AWS-Region in einer globalen Neptune-Datenbank von der primären AWS-Region zur sekundären Datenbank übertragen wurden. | | `GlobalDbReplicatedWriteIO` | Die Anzahl der I/O Schreibvorgänge, die von der Primärdatenbank in der globalen Datenbank auf das Cluster-Volume AWS-Region in einer Sekundärdatenbank repliziert wurden. AWS-Region Die Abrechnungsberechnungen für jeden DB-Cluster in einer globalen Neptune-Datenbank verwenden die `VolumeWriteIOPS`-Metrik, um die im Cluster ausgeführten Schreibvorgänge zu berücksichtigen. Für den primären DB-Cluster verwenden die Abrechnungsberechnungen `GlobalDbReplicatedWriteIO` zur Berücksichtigung der regionsübergreifenden Replikation zu sekundären DB-Clustern. | | `GlobalDbProgressLag` | Die Anzahl von Millisekunden, die ein sekundärer Cluster bei Benutzertransaktionen und Systemtransaktionen hinter dem primären Cluster zurückliegt. | | `GremlinClientErrorsPerSec` | Anzahl der clientseitigen Fehler pro Sekunde in Gremlin-Transversalen. | | `GremlinServerErrorsPerSec` | Anzahl der serverseitigen Fehler pro Sekunde in Gremlin-Transversalen. | | `GremlinRequestsPerSec` | Anzahl der Anforderungen pro Sekunde an die Gremlin-Engine. | | `GremlinWebSocketOpenConnections` | Die Anzahl der offenen WebSocket Verbindungen zu Neptune. | | `LoaderClientErrorsPerSec` | Anzahl der clientseitigen Fehler pro Sekunde von Loader-Anforderungen. | | `LoaderRequestsPerSec` | Anzahl der Loader-Anforderungen pro Sekunde. | | `LoaderServerErrorsPerSec` | Anzahl der serverseitigen Loader-Fehler pro Sekunde. | | `MainRequestQueuePendingRequests` | Die Anzahl der Anforderungen in der Eingabewarteschlange, deren Ausführung aussteht. Neptune beginnt mit der Drosselung von Anforderugnen, wenn sie die maximale Warteschlangenkapazität überschreiten. | | `NCUUtilization``` | Gilt nur für [Neptune-Serverless](neptune-serverless.md)-DB-Instances oder -DB-Cluster. Meldet auf Instance-Ebene einen Prozentsatz, berechnet als die Anzahl der Neptune-Kapazitätseinheiten (NCUs), die derzeit von der fraglichen Instance verwendet werden, geteilt durch die maximale NCU-Kapazitätseinstellung für den Cluster. Eine Neptune Capacity Unit (NCU) besteht aus einem Arbeitsspeicher (RAM) mit 2 GiB (Gibibyte) sowie der entsprechenden Kapazität des virtuellen Prozessors (vCPU) und des Netzwerks. `NCUUtilization` meldet auf Cluster-Ebene den Prozentsatz der maximalen Kapazität an, der vom gesamten Cluster verwendet wird. | | `NetworkThroughput` | Die Menge des Netzwerkdurchsatzes in Byte pro Sekunde, der von jeder Instance im DB-Cluster von Clients empfangen und an Clients gesendet wird. Dieser Durchsatz enthält **nicht** den Netzwerkdatenverkehr zwischen Instances im DB-Cluster und dem Cluster-Volume. | | `NetworkTransmitThroughput` | Die Menge des ausgehenden Netzwerkdurchsatzes in Byte pro Sekunde, der von jeder Instance im Neptune-DB-Cluster an Clients gesendet wird. Dieser Durchsatz enthält **nicht** den Netzwerkdatenverkehr zwischen Instances im DB-Cluster und dem Cluster-Volume. | | NumIndexDeletesPerSec | Anzahl der Löschungen aus einzelnen Indizes. Löschungen aus jedem Index werden einzeln gezählt. Dazu gehören auch die Löschungen, die rückgängig gemacht werden können, wenn bei einer Abfrage ein Fehler auftritt. | | NumIndexInsertsPerSec | Anzahl der Einfügungen in einzelne Indizes. Einfügungen in jeden Index werden separat gezählt. Dazu gehören auch die Einfügungen, die möglicherweise zurückgesetzt werden, wenn bei einer Abfrage ein Fehler auftritt. | | NumIndexReadsPerSec | Anzahl der aus einem beliebigen Index gescannten Anweisungen. Jedes Zugriffsmuster beginnt mit einer Suche in einem Index und dem Lesen aller passenden Anweisungen. Eine Erhöhung dieser Metrik kann zu einer Erhöhung der Abfragelatenzen oder der CPU-Auslastung führen. | | `NumOpenCypherClientErrorsPerSec` | Die Anzahl der OpenCypher Client-Fehler pro Sekunde. | | `NumOpenCypherRequestsPerSec` | Die Anzahl der OpenCypher Anfragen pro Sekunde. | | `NumOpenCypherServerErrorsPerSec` | Die Anzahl der OpenCypher Serverfehler pro Sekunde. | | `NumQueuedRequestsPerSec` | Die Anzahl der Anfragen, die pro Sekunde in die Warteschlange gestellt wurden. | | `NumResultCacheHit` | Anzahl der Treffer im Gremlin-Ergebniscache. | | `NumResultCacheMiss` | Anzahl der Fehlschläge im Gremlin-Ergebniscache. | | `NumTxCommitted` | Die Anzahl der Transaktionen pro Sekunde, für die ein Commit durchgeführt wurde. | | `NumTxOpened` | Die Anzahl der pro Sekunde auf dem Server geöffneten Transaktionen. | | `NumTxRolledBack` | Bei Schreibabfragen die Anzahl der Transaktionen pro Sekunde, die auf dem Server aufgrund von Fehlern rückgängig gemacht wurden. Bei schreibgeschützten Abfragen entspricht diese Metrik der Anzahl der abgeschlossenen schreibgeschützten Transaktionen pro Sekunde. | | NumUndoPagesPurged | Diese Metrik gibt die Anzahl der gelöschten Batches an. Diese Kennzahl ist ein Indikator für den Fortschritt beim Löschen. Der Wert gilt 0 für Reader-Instances, und die Metrik gilt nur für die Writer-Instanz. | | `OpenCypherRequestsPerSec` | Anzahl der Anforderungen pro Sekunde (HTTPS und Bolt) an die openCypher-Engine. | | `OpenCypherBoltOpenConnections` | Die Anzahl offener Bolt-Verbindungen mit Neptune. | | `ResultCacheSizeInBytes` | Geschätzte Gesamtgröße (in Byte) aller zwischengespeicherten Elemente im Gremlin-Ergebniscache. | | `ResultCacheItemCount` | Anzahl der Elemente im Gremlin-Ergebniscache. | | `ResultCacheOldestItemTimestamp` | Der Zeitstempel des ältesten Elements, das im Gremlin-Ergebniscache zwischengespeichert wurde. | | `ResultCacheNewestItemTimestamp` | Der Zeitstempel des neuesten Elements, das im Gremlin-Ergebniscache zwischengespeichert wurde. | | `ServerlessDatabaseCapacity` | Meldet als Metrik auf Instanzebene die `ServerlessDatabaseCapacity` aktuelle Instanzkapazität einer bestimmten [serverlosen Neptune-Instance](neptune-serverless.md) in. NCUs Eine Neptune Capacity Unit (NCU) besteht aus einem Arbeitsspeicher (RAM) mit 2 GiB (Gibibyte) sowie der entsprechenden Kapazität des virtuellen Prozessors (vCPU) und des Netzwerks. Als Metrik auf Cluster-Ebene meldet `ServerlessDatabaseCapacity` den Durchschnitt aller `ServerlessDatabaseCapacity`-Werte der DB-Instances im Cluster an. | | `SnapshotStorageUsed` | Der gesamte Sicherungsspeicher, der von allen Snapshots für einen Neptune-DB-Cluster außerhalb des Sicherungs-Aufbewahrungszeitraums verwendet wird (in Byte). Ist in dem von der `TotalBackupStorageBilled`-Metrik gemeldeten Gesamtwert enthalten. | | `SparqlClientErrorsPerSec` | Die Anzahl der clientseitigen Fehler pro Sekunde in SPARQL-Abfragen. | | `SparqlRequestsPerSec` | Die Anzahl der Anforderungen pro Sekunde an die SPARQL-Engine. | | `SparqlServerErrorsPerSec` | Die Anzahl der SPARQL-Serverfehler pro Sekunde. | | `StatsNumStatementsScanned` | Die Gesamtzahl der Anweisungen, die seit dem Serverstart für [DFE-Statistiken](neptune-dfe-statistics.md) gescannt wurden. Bei jeder Auslösung einer Statistikberechnung nimmt diese Zahl zu. Wenn keine Berechnung stattfindet, bleibt sie jedoch konstant. Wenn Sie ein Zeitverlaufdiagramm erstellen, können Sie daher erkennen, wann die Berechnung stattgefunden hat und wann nicht: ![\[Diagramm der StatsNumStatementsScanned-Werte im Zeitverlauf\]](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/images/StatsNumStatementsScanned-graph.png) Wenn Sie die Steigung des Diagramms in Zeiträumen betrachten, in denen die Metrik zunimmt, können Sie auch erkennen, wie schnell die Berechnung durchgeführt wurde. Wenn es keine solche Metrik gibt, bedeutet dies, dass das Statistik-Feature im DB-Cluster deaktiviert ist oder dass die verwendete Engine-Version nicht über das Statistik-Feature verfügt. Wenn der Metrikwert null ist, bedeutet dies, dass keine Statistikberechnung stattgefunden hat. | | `StorageNetworkReceiveThroughput` | Die Menge des Netzwerkdurchsatzes, den jede Instance im Neptune-DB-Cluster vom Speichersubsystem erhält. | | StorageNetworkThroughput | Die Menge des Netzwerkdurchsatzes, der von jeder Instance im Neptune-DB-Cluster vom Speichersubsystem empfangen und an das Speichersubsystem gesendet wird. | | `StorageNetworkTransmitThroughput` | Die Menge des Netzwerkdurchsatzes, der von jeder Instance im Neptune DB-Cluster an das Speichersubsystem gesendet wird. | | `SwapUsage` | Die Größe des verwendeten Auslagerungsbereichs. | | `TempStorageIOPS` | Die Anzahl der IOPS für Lese- und Schreibvorgänge auf dem lokalen Speicher, der an die Neptune-DB-Instance angeschlossen ist. Diese Metrik stellt eine Zählung dar und wird einmal pro Sekunde gemessen. | | `TempStorageThroughput` | Die Datenmenge, die zum und vom lokalen Speicher übertragen wird, der der Neptune-DB-Instance zugeordnet ist. Diese Metrik wird in Byte angegeben und einmal pro Sekunde gemessen. | | `TotalBackupStorageBilled` | Der gesamte Sicherungsspeicher, der Ihnen für einen bestimmten Neptune-DB-Cluster berechnet wird (in Byte). Umfasst den Sicherungsspeicher gemessen an den Metriken `SnapshotStorageUsed` und `BackupRetentionPeriodStorageUsed`. | | `TotalRequestsPerSec` | Die Gesamtzahl der Anfragen pro Sekunde an den Server aus allen Quellen. | | `TotalClientErrorsPerSec` | Die Gesamtzahl der Anfragen pro Sekunde, die aufgrund von clientseitigen Problemen zu Fehlern führten. | | `TotalServerErrorsPerSec` | Die Gesamtzahl der Anfragen pro Sekunde, die aufgrund interner Ausfälle auf dem Server zu Fehlern führten. | | `UndoLogListSize` | Die Anzahl der Undo-Protokolle in der Liste der Undo-Protokolle. Undo-Logs enthalten Datensätze zu Commit-Transaktionen, die ablaufen, wenn alle aktiven Transaktionen jünger als die Commit-Zeit sind. Die abgelaufenen Datensätze werden regelmäßig gelöscht. Das Löschen von Datensätzen für Löschvorgänge kann länger dauern als das Löschen von Datensätzen für andere Transaktionsarten. Das Löschen erfolgt ausschließlich über die Writer-Instance des DB-Clusters, sodass die Geschwindigkeit des Löschvorgangs vom Typ der Writer-Instance abhängig ist. Wenn der Wert für `UndoLogListSize` hoch ist und im DB-Cluster steigt, sollten Sie die Writer-Instance heraufstufen, um die Löschrate zu erhöhen. Wenn Sie von einer älteren Version auf Engine-Version `1.2.0.0` oder höher aktualisieren, stellen Sie außerdem zunächst sicher`1.2.0.0`, dass der `UndoLogListSize` Wert unter einem bestimmten Schwellenwert liegt. Andernfalls wird der Patch zurückgesetzt und schlägt fehl. Die Schwellenwerte hängen vom Instance-Typ ab: Das Standardlimit liegt bei 40.000 für 4xlarge- oder größere Instances und 10.000 für Instances, die kleiner als 4xlarge sind. Wenn Sie versuchen, einen Cluster zu aktualisieren, dessen `UndoLogListSize` Metrik über dem Limit liegt, wird der Patch-Vorgang zurückgesetzt, das Upgrade wird abgebrochen und ein Ereignis mit dem Grund wird auf der Cluster-Ereignisseite angezeigt. Diese Grenzwerte können sich aus betrieblichen Gründen ohne vorherige Warnung ändern. Da Engine-Versionen `1.2.0.0` und höher ein anderes Format für Undo-Logs verwenden, kann das Upgrade erst beginnen, nachdem Ihre vorherigen Undo-Logs vollständig gelöscht wurden und den geltenden Schwellenwert unterschritten haben. Weitere Informationen finden Sie unter [Upgrade zu 1.2.0.0 oder höher](engine-updates-1200-changes.md). | | `VolumeBytesUsed` | Die Gesamtmenge des Speichers, der Ihrem Neptune-DB-Cluster zugeteilt ist (in Byte). Dies ist die Speichermenge, die Ihnen in Rechnung gestellt wird. Dies ist die maximale Speichermenge, die Ihrem DB-Cluster zu einem beliebigen Zeitpunkt seines Bestehens zugewiesen ist, und nicht die Menge, die Sie derzeit verwenden (siehe [Neptune-Speicher-Fakturierung](feature-overview-storage.md#feature-overview-storage-billing)). | | `VolumeReadIOPs` | Die Gesamtzahl der abgerechneten I/O Lesevorgänge von einem Cluster-Volume, angegeben in 5-Minuten-Intervallen. Berechnete Lesevorgänge werden auf Cluster-Volume-Ebene berechnet, aggregiert aus allen Instances im Neptune-DB-Cluster und in Intervallen von 5 Minuten gemeldet. | | VolumeWriteIOPs | Die Gesamtzahl der I/O Festplattenschreibvorgänge auf das Cluster-Volume, die in Intervallen von 5 Minuten gemeldet wurden. | ## CloudWatch Metriken, die jetzt in Neptune veraltet sind Die Verwendung dieser Neptune-Metriken ist jetzt nicht mehr möglich. Sie werden weiterhin unterstützt, können aber in Zukunft eliminiert werden, wenn neue und bessere Metriken verfügbar werden. | Metrik | Description | | --- | --- | | `GremlinHttp1xx` | Anzahl der HTTP 1xx-Antworten für den Gremlin-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http1xx`-Metrik. | | `GremlinHttp2xx` | Anzahl der HTTP 2xx-Antworten für den Gremlin-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http2xx`-Metrik. | | `GremlinHttp4xx` | Anzahl der HTTP 4xx-Fehler für den Gremlin-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http4xx`-Metrik. | | `GremlinHttp5xx` | Anzahl der HTTP 5xx-Fehler für den Gremlin-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http5xx`-Metrik. | | `GremlinErrors` | Anzahl der Fehler in Gremlin-Traversals. | | `GremlinRequests` | Anzahl der Anforderungen an die Gremlin-Engine. | | `GremlinWebSocketSuccess` | Anzahl erfolgreicher WebSocket Verbindungen zum Gremlin-Endpunkt pro Sekunde. | | `GremlinWebSocketClientErrors` | Anzahl der WebSocket Client-Fehler auf dem Gremlin-Endpunkt pro Sekunde. | | `GremlinWebSocketServerErrors` | Anzahl der WebSocket Serverfehler auf dem Gremlin-Endpunkt pro Sekunde. | | `GremlinWebSocketAvailableConnections` | Anzahl der derzeit verfügbaren potenziellen WebSocket Verbindungen. | | `Http100` | Anzahl der HTTP 100-Antworten für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http1xx`-Metrik. | | `Http101` | Anzahl der HTTP 101-Antworten für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http1xx`-Metrik. | | `Http1xx` | Anzahl der HTTP 1xx-Antworten für den Endpunkt pro Sekunde. | | `Http200` | Anzahl der HTTP 200-Antworten für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http2xx`-Metrik. | | `Http2xx` | Anzahl der HTTP 2xx-Antworten für den Endpunkt pro Sekunde. | | `Http400` | Anzahl der HTTP 400-Fehler für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http4xx`-Metrik. | | `Http403` | Anzahl der HTTP 403-Fehler für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http4xx`-Metrik. | | `Http405` | Anzahl der HTTP 405-Fehler für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http4xx`-Metrik. | | `Http413` | Anzahl der HTTP 413-Fehler für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http4xx`-Metrik. | | `Http429` | Anzahl der HTTP 429-Fehler für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http4xx`-Metrik. | | `Http4xx` | Anzahl der HTTP 4xx-Fehler für den Endpunkt pro Sekunde. | | `Http500` | Anzahl der HTTP 500-Fehler für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http5xx`-Metrik. | | `Http501` | Anzahl der HTTP 501-Fehler für den Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http5xx`-Metrik. | | `Http5xx` | Anzahl der HTTP 5xx-Fehler für den Endpunkt pro Sekunde. | | `LoaderErrors` | Anzahl der Fehler von Loader-Anforderungen. | | `LoaderRequests` | Anzahl der Loader-Anforderungen. | | `SparqlHttp1xx` | Anzahl der HTTP 1xx-Antworten für den SPARQL-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http1xx`-Metrik. | | `SparqlHttp2xx` | Anzahl der HTTP 2xx-Antworten für den SPARQL-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http2xx`-Metrik. | | `SparqlHttp4xx` | Anzahl der HTTP 4xx-Fehler für den SPARQL-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http4xx`-Metrik. | | `SparqlHttp5xx` | Anzahl der HTTP 5xx-Fehler für den SPARQL-Endpunkt pro Sekunde. Wir empfehlen stattdessen die Verwendung der neuen kombinierten `Http5xx`-Metrik. | | `SparqlErrors` | Anzahl der Fehler in den SPARQL-Abfragen. | | `SparqlRequests` | Anzahl der Anforderungen an die SPARQL-Engine. | | `StatusErrors` | Anzahl der Fehler vom Statusendpunkt. | | `StatusRequests` | Anzahl der Anforderungen an den Statusendpunkt. | # CloudWatch Neptun-Dimensionen Die Metriken für Amazon Neptune werden durch die Werte für das Konto, den Diagrammnamen oder die Operation qualifiziert. Sie können die CloudWatch Amazon-Konsole verwenden, um Neptun-Daten zusammen mit allen Dimensionen in der folgenden Tabelle abzurufen. | Dimension | Description | | --- | --- | | DBInstanceIdentifier | Filtert die angeforderten Daten für eine bestimmte Datenbank-Instance innerhalb eines Clusters. | | DBClusterIdentifier | Filtert die angeforderten Daten für einen spezifischen Neptune-DB-Cluster. | | DBClusterIdentifier, EngineName | Filtert die Daten nach dem Cluster. Der Name der Engine für alle Neptune-Instances ist neptune. | | DBClusterIdentifier, Role | Filtert die angeforderten Daten für einen bestimmten Neptune-DB-Cluster und fasst die Metrik nach Instance-Rolle (WRITER/READER) zusammen. Sie können beispielsweise Metriken für alle READER-Instances eines Clusters zusammenfassen. | | DBClusterIdentifier, SourceRegion | Filtert die Daten nach dem primären Cluster in einer primären Region der globalen Datenbank. | | DatabaseClass | Filtert die angeforderten Daten für alle Instances einer Datenbankklasse. Sie können beispielsweise Metriken für alle Instances der Datenbankklasse db.r4.large zusammenfassen. | | EngineName | Der Name der Engine für alle Neptune-Instances ist neptune. | | GlobalDbDBClusterIdentifier, SecondaryRegion | Filtert die Daten nach dem sekundären Cluster einer angegebenen globalen Datenbank in einer sekundären Region. | # Verwenden von Prüfprotokollen mit Amazon-Neptune-Clustern Um die Aktivität in Amazon-Neptune-DB-Clustern zu überwachen, aktivieren Sie die Erfassung von Prüfprotokollen durch Festlegen eines DB-Cluster-Parameters. Wenn Prüfprotokolle aktiviert sind, können Sie sie verwenden, um eine beliebige Kombination von unterstützten Ereignissen zu protokollieren. Sie können die Prüfprotokolle ansehen oder herunterladen, um sie zu überprüfen. ## Aktivieren von Neptune-Prüfprotokollen Verwenden Sie den Parameter `neptune_enable_audit_log` zum Aktivieren (`1`) oder Deaktivieren (`0`) von Prüfprotokollen. Legen Sie diesen Parameter in der Parametergruppe fest, die von Ihrem DB-Cluster verwendet wird. Sie können das unter beschriebene Verfahren verwenden, [Bearbeiten einer DB-Cluster-Parametergruppe oder DB-Parametergruppe](parameter-groups.md#parameters-editgroup) um den Parameter mithilfe von zu ändern AWS-Managementkonsole, oder den Befehl [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/neptune/modify-db-cluster-parameter-group.html) oder den AWS CLI Befehl [Modify DBCluster ParameterGroup](API_ModifyDBClusterParameterGroup.html) API verwenden, um den Parameter programmatisch zu ändern. Sie müssen nach der Änderung dieses Parameters die DB-Instances neu starten, um die Änderung anzuwenden. ## Anzeigen von Neptune-Prüfprotokollen über die Konsole Sie können Prüfprotokolle mithilfe der AWS-Managementkonsole-Konsole anzeigen und herunterladen. Wählen Sie auf der Seite **Instances** die DB-Instance aus, um ihre Details anzuzeigen, und scrollen Sie dann in den Abschnitt **Logs (Protokolle)**. Suchen Sie diese Datei im Abschnitt**Logs (Protokolle)** und wählen Sie anschließend **Download (Herunterladen)** aus, um die Protokolldatei herunterzuladen. ## Einzelheiten zu Neptune-Prüfprotokollen Protokolldateien haben das Format UTF-8. Protokolle sind in verschiedene Dateien geschrieben, deren Anzahl je nach Größe der Instance variiert. Sie müssen eventuell alle Prüfprotokolle überprüfen, um die aktuellen Ereignisse zu sehen. Protokolleinträge folgen keiner sequenziellen Reihenfolge. Sie können den `timestamp`-Wert verwenden, um sie zu sortieren. Protokolldateien werden rotiert, wenn Sie eine Größe von 100 MB erreichen. Dieses Limit ist nicht konfigurierbar. Die Prüfprotokolldateien enthalten die folgenden durch Komma getrennten Informationen in Zeilen, in der folgenden Reihenfolge: | Feld | Beschreibung | | --- | --- | | Zeitstempel | Der auf die Mikrosekunde genaue Unix-Zeitstempel für das protokollierte Ereignis. | | ClientHost | Der Hostname oder die IP, von dem sich der Benutzer verbunden hat. | | ServerHost | Der Hostname oder die IP der Instance, für die das Ereignis protokolliert wird. | | ConnectionType | Der Verbindungstyp. Kann Websocket, HTTP\$1POST, HTTP\$1GET oder Bolt sein. | | IAM-ARN der aufrufenden Entität | Der ARN des IAM-Benutzers oder der IAM-Rolle, mit dem die Anforderung signiert wurde. Leer, wenn die IAM-Authentifizierung deaktiviert ist. Das Format ist: `arn:partition:service:region:account:resource` Beispiel: `arn:aws:iam::123456789012:user/Anna` `arn:aws:sts::123456789012:assumed-role/AWSNeptuneNotebookRole/SageMaker` | | Auth Context | Enthält ein serialisiertes JSON-Objekt mit Authentifizierungsinformationen. Das Feld `authenticationSucceeded` ist `True`, wenn der Benutzer authentifiziert wurde. Leer, wenn die IAM-Authentifizierung deaktiviert ist. | | HttpHeader | Die HTTP-Header-Informationen. Kann eine Abfrage enthalten. Leere Verbindungen für WebSocket und Bolt. | | Nutzlast | Die Gremlin-, SPARQL- oder openCypher-Abfrage. | # Neptune Logs auf Amazon Logs veröffentlichen CloudWatch Sie können einen Neptune-DB-Cluster so konfigurieren, dass er Protokolldaten and/or mit langsamer Abfrage in einer Protokollgruppe in Amazon Logs veröffentlicht. CloudWatch Mit CloudWatch Logs können Sie die Protokolldaten in Echtzeit analysieren und sie zum Erstellen von Alarmen und CloudWatch zum Anzeigen von Metriken verwenden. Sie können CloudWatch Logs verwenden, um Ihre Protokolldatensätze in einem äußerst langlebigen Speicher zu speichern. Um Audit-Logs in CloudWatch Logs zu veröffentlichen, müssen Audit-Logs explizit aktiviert werden (siehe[Aktivieren von Prüfprotokollen](auditing.md#auditing-enable)). Ebenso müssen Slow-Query-Logs explizit aktiviert werden, um CloudWatch Slow-Query-Logs in Logs zu veröffentlichen (siehe). [Verwenden der Amazon-Neptune-Protokollierung für langsame Abfragen](slow-query-logs.md) **Anmerkung** Achten Sie auf Folgendes: Zusätzliche Gebühren fallen an, wenn Sie Protokolle in veröffentlichen. CloudWatch Einzelheiten finden Sie auf der [CloudWatch Preisseite](https://aws.amazon.com/cloudwatch/pricing/). Sie können keine Logs für die Regionen China (Peking) oder China (Ningxia) in CloudWatch Logs veröffentlichen. Wenn der Export von Protokolldaten deaktiviert ist, löscht Neptune keine vorhandenen Protokollgruppen oder Protokoll-Streams. Wenn der Export von Protokolldaten deaktiviert ist, bleiben vorhandene Protokolldaten je nach Aufbewahrung der CloudWatch Protokolle in Logs verfügbar, und es fallen weiterhin Gebühren für gespeicherte Audit-Protokolldaten an. Sie können Protokollstreams und Protokollgruppen mithilfe der CloudWatch Logs-Konsole AWS CLI, der oder der CloudWatch Logs-API löschen. ## Verwenden der Konsole zum Veröffentlichen von Neptune-Protokollen in Logs CloudWatch **Um Neptune-Logs von der Konsole aus in CloudWatch Logs zu veröffentlichen** 1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Neptune Neptune-Konsole zu Hausehttps://console.aws.amazon.com/neptune/.](https://console.aws.amazon.com/neptune/home) 1. Wählen Sie im Navigationsbereich **Datenbanken** aus. 1. Wählen Sie den Neptune-DB-Cluster aus, für den die Protokolldaten veröffentlicht werden sollen. 1. Wählen Sie für **Actions (Aktionen)** die Option **Modify (Ändern)** aus. 1. Wählen Sie im Abschnitt **Protokollexporte** die Protokolle aus, die Sie in Logs veröffentlichen möchten CloudWatch . 1. Wählen Sie **Weiter** und dann auf der Übersichtsseite **DB-Cluster ändern**. ## Verwenden der CLI zum Veröffentlichen von Neptune-Auditprotokollen in Logs CloudWatch Sie können einen neuen DB-Cluster erstellen, der Audit-Logs in CloudWatch Logs veröffentlicht, indem Sie den AWS CLI `create-db-cluster` Befehl mit den folgenden Parametern verwenden: ``` aws neptune create-db-cluster \ --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --engine neptune \ --enable-cloudwatch-logs-exports '["audit"]' ``` Sie können einen vorhandenen DB-Cluster so konfigurieren, dass er Audit-Logs in CloudWatch Logs veröffentlicht, indem Sie den AWS CLI `modify-db-cluster` Befehl mit den folgenden Parametern verwenden: ``` aws neptune modify-db-cluster \ --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit"]}' ``` ## Verwenden der CLI zum Veröffentlichen von Neptune-Protokollen für langsame Abfragen in Logs CloudWatch Sie können auch einen neuen DB-Cluster erstellen, der Logs für langsame Abfragen in Logs veröffentlicht, CloudWatch indem Sie den AWS CLI `create-db-cluster` Befehl mit den folgenden Parametern verwenden: ``` aws neptune create-db-cluster \ --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --engine neptune \ --enable-cloudwatch-logs-exports '["slowquery"]' ``` In ähnlicher Weise können Sie einen vorhandenen DB-Cluster so konfigurieren, dass er Logs mit langsamen Abfragen in Logs veröffentlicht, CloudWatch indem Sie den AWS CLI `modify-db-cluster` Befehl mit den folgenden Parametern verwenden: ``` aws neptune modify-db-cluster --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --cloudwatch-logs-export-configuration '{"EnableLogTypes":["slowquery"]}' ``` ## Überwachung Neptune Neptune-Protokollereignissen in Amazon CloudWatch Nachdem Sie Neptune Logs aktiviert haben, können Sie Protokollereignisse in Amazon CloudWatch Logs überwachen. Für den Neptune-DB-Cluster wird automatisch eine neue Protokollgruppe mit dem folgenden Präfix erstellt. Dabei repräsentiert `cluster-name` den Namen des DB-Clusters und `log_type` den Protokolltyp: ``` /aws/neptune/cluster-name/log_type ``` Wenn Sie beispielsweise die Exportfunktion so konfigurieren, dass das Prüfprotokoll für einen DB-Cluster namens `mydbcluster` eingefügt wird, werden die Protokolldaten in der Protokollgruppe `/aws/neptune/mydbcluster/audit` gespeichert. Alle Auditereignisse aus allen DB-Instances in einem DB-Cluster werden von einer Protokollgruppe unter Verwendung verschiedener Protokollstreams erfasst. Wenn bereits eine Protokollgruppe mit dem angegebenen Namen vorhanden ist, verwendet Neptune diese Protokollgruppe, um Protokolldaten für den Neptune-DB-Cluster zu exportieren. Sie können die automatische Konfiguration verwenden AWS CloudFormation, um beispielsweise Protokollgruppen mit vordefinierten Aufbewahrungsfristen für Protokolle, Metrikfiltern und Kundenzugriff zu erstellen. Andernfalls wird automatisch eine neue Protokollgruppe erstellt, wobei der standardmäßige Aufbewahrungszeitraum für Protokolle, „**Niemals ablaufen**“, in CloudWatch Logs verwendet wird. Sie können die CloudWatch Logs-Konsole AWS CLI, die oder die CloudWatch Logs-API verwenden, um den Aufbewahrungszeitraum für Protokolle zu ändern. Weitere Informationen zur Änderung der Aufbewahrungsfristen für CloudWatch Protokolle in Logs finden Sie unter [Ändern der Aufbewahrung von Protokolldaten in CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html). Sie können die CloudWatch Logs-Konsole, die oder die CloudWatch Logs-API verwenden AWS CLI, um in den Protokollereignissen für einen DB-Cluster nach Informationen zu suchen. Weitere Informationen finden Sie unter [Suchen und Filtern von Protokolldaten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringLogData.html). # Amazon CloudWatch Logs für ein Neptune-Notizbuch aktivieren CloudWatch Protokolle für Neptune-Notebooks sind standardmäßig deaktiviert. Gehen Sie zur Aktivierung wie folgt vor, beispielsweise zum Debuggen oder für andere Zwecke: **Verwenden von AWS-Managementkonsole , um CloudWatch Logs für ein Neptune-Notizbuch zu aktivieren** 1. Öffnen Sie die Amazon SageMaker AI-Konsole unter [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/). 1. Wählen Sie im Navigationsbereich auf der linken Seite **Notebook** und dann **Notebook-Instances** aus. Suchen Sie nach dem Namen des Neptune-Notebooks, für das Sie Protokolle aktivieren möchten. 1. Gehen Sie zur Detailseite, indem Sie den Namen der Notebook-Instance auswählen, der im Schritt oben genannt wurde. 1. Wenn die Notebook-Instance ausgeführt wird, klicken Sie oben rechts auf der Notebook-Detailseite auf die Schaltfläche **Stoppen**. 1. Unter **Berechtigungen und Verschlüsselung** gibt es ein Feld für den **IAM-Rollen-ARN**. Wählen Sie den Link in diesem Feld aus, um zur IAM-Rolle für diesen Notebook zu wechseln. 1. Erstellen Sie die folgende Richtlinie: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogDelivery", "logs:CreateLogGroup", "logs:CreateLogStream", "logs:DeleteLogDelivery", "logs:Describe*", "logs:GetLogDelivery", "logs:GetLogEvents", "logs:ListLogDeliveries", "logs:PutLogEvents", "logs:PutResourcePolicy", "logs:UpdateLogDelivery" ], "Resource": "*" } ] } ``` ------ 1. Speichern Sie diese neue Richtlinie und fügen Sie sie an die IAM-Rolle aus Schritt 4 an. 1. Wählen Sie oben rechts auf der Detailseite der SageMaker AI-Notebook-Instanz die Option **Start** aus. 1. Sobald Protokolle erstellt werden, sollte der Link **Protokolle anzeigen** unterhalb des Felds **Lifecycle-Konfiguration** unten links auf der Detailseite im Abschnitt **Notebook-Instance-Einstellungen** angezeigt werden. Wenn Ihr Notebook nicht gestartet werden kann, wird auf der Seite mit den Notebook-Details auf der SageMaker AI-Konsole eine Meldung angezeigt, dass der Start der Notebook-Instanz mehr als 5 Minuten gedauert hat. Die für dieses Problem relevanten CloudWatch Protokolle finden Sie unter dem Namen:`(your-notebook-name)/LifecycleConfigOnStart`. Weitere Informationen finden Sie [bei Bedarf unter SageMaker CloudWatch Amazon-Ereignisse bei Amazon protokollieren](https://docs.aws.amazon.com/sagemaker/latest/dg/logging-cloudwatch.html). # Verwenden der Amazon-Neptune-Protokollierung für langsame Abfragen Das Identifizieren, Debuggen und Optimieren einer langsam ausgeführten Abfrage kann schwierig sein. Wenn die Neptune-Protokollierung für langsame Abfragen aktiviert ist, werden die Attribute aller Abfragen mit langer Laufzeit automatisch protokolliert, um diesen Vorgang zu vereinfachen. **Anmerkung** Die Protokollierung langsamer Abfragen wurde in der [Neptune-Engine-Version 1.2.1.0](engine-releases-1.2.1.0.md) eingeführt. Sie aktivieren die Protokollierung langsamer Abfragen mit dem DB-Cluster-Parameter [neptune\$1enable\$1slow\$1query\$1log](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log). Dieser Parameter ist standardmäßig auf `disabled` festgelegt. Wenn Sie ihn auf `info` oder `debug` festlegen, wird die Protokollierung für langsame Abfragen aktiviert. Die Einstellung `info` protokolliert einige nützliche Attribute für jede langsam ausgeführte Abfrage. Die Einstellung `debug` protokolliert hingegen alle verfügbaren Attribute. Um den Schwellenwert für eine als langsam ausgeführte Abfrage betrachtete Abfrage festzulegen, verwenden Sie den DB-Cluster-Parameter [neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold), um die Anzahl der Millisekunden anzugeben, nach der eine Abfrage als langsam betrachtet und protokolliert wird, wenn die Protokollierung langsamer Abfragen aktiviert ist. Der Standardwert ist 5.000 Millisekunden (5 Sekunden). Sie können diese DB-Cluster-Parameter [im AWS-Managementkonsole](parameter-groups.md#parameters-editgroup) oder mithilfe des AWS CLI Befehls [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/neptune/modify-db-cluster-parameter-group.html) oder der DBCluster ParameterGroup Verwaltungsfunktion [Modify](api-parameters.md#ModifyDBClusterParameterGroup) festlegen. **Anmerkung** Die Protokollierungsparameter für langsame Abfragen sind dynamisch. Das bedeutet, dass das Ändern ihrer Werte keinen Neustart des DB-Clusters erfordert oder verursacht. ## Um Logs für langsame Abfragen anzuzeigen, finden Sie im AWS-Managementkonsole Sie können Protokolle für langsame Abfragen wie folgt im anzeigen und herunterladen: AWS-Managementkonsole Wählen Sie auf der Seite **Instances** eine DB-Instance aus und scrollen Sie dann zum Abschnitt **Protokolle**. Sie können dort eine Protokolldatei auswählen und dann **Herunterladen** auswählen, um sie herunterzuladen. ## Dateien, die von der Neptune-Protokollierung für langsame Abfragen generiert werden Die durch die Protokollierung für langsame Abfragen generierten Protokolldateien besitzen die folgenden Eigenschaften: + Die Dateien sind als UTF-8 kodiert. + Abfragen und ihre Attribute werden im JSON-Format protokolliert. + Null- und leere Attribute werden nicht protokolliert, außer `queryTime`-Daten. + Protokolle umfassen mehrere Dateien, deren Anzahl von der Größe der Instance abhängig ist. + Protokolleinträge folgen keiner sequenziellen Reihenfolge. Sie können ihre `timestamp`-Werte verwenden, um sie anzuordnen. + Sie müssen möglicherweise alle Protokolldateien für langsame Abfragen überprüfen, um die neuesten Ereignisse anzuzeigen. + Protokolldateien werden rotiert, wenn sie zusammen die Größe von 100 MiB erreichen. Dieses Limit ist nicht konfigurierbar. ## Im `info`-Modus protokollierte Abfrageattribute Die folgenden Attribute werden für langsame Abfragen protokolliert, wenn der DB-Cluster-Parameter `neptune_enable_slow_query_log` auf `info` festgelegt wurde: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/slow-query-logs.html) ## Im `debug`-Modus protokollierte Abfrageattribute Wenn der `neptune_enable_slow_query_log`-DB-Cluster-Parameter auf `debug` festgelegt wurde, werden zusätzlich zu den Attributen, die im `info`-Modus protokolliert werden, die folgenden Speicherzähler-Attribute protokolliert: | Attribut | Description | | --- | --- | | `statementsScannedInAllIndexes` | Zahl der in allen Indizes gescannten Anweisungen. | | `statementsScannedSPOGIndex` | Zahl der im SPOG-Index gescannten Anweisungen. | | `statementsScannedPOGSIndex` | Zahl der im POGS-Index gescannten Anweisungen. | | `statementsScannedGPSOIndex` | Zahl der im GPSO-Index gescannten Anweisungen. | | `statementsScannedOSGPIndex` | Zahl der im OSGP-Index gescannten Anweisungen. | | `statementsScannedInChunk` | Zahl der zusammen im Block gescannten Anweisungen. | | `postFilteredStatementScans` | Zahl der Anweisungen, die nach dem Filtern nach dem Scannen übrig sind. | | `distinctStatementScans` | Zahl der eindeutigen gescannten Anweisungen. | | `statementsReadInAllIndexes` | Zahl der gelesenen Anweisungen nach dem Scannen nach dem Filtern in allen Indizes. | | `statementsReadSPOGIndex` | Zahl der gelesenen Anweisungen nach dem Scannen nach dem Filtern im SPOG-Index. | | `statementsReadPOGSIndex` | Zahl der gelesenen Anweisungen nach dem Scannen nach dem Filtern im POGS-Index. | | `statementsReadGPSOIndex` | Zahl der gelesenen Anweisungen nach dem Scannen nach dem Filtern im GPSO-Index. | | `statementsReadOSGPIndex` | Zahl der gelesenen Anweisungen nach dem Scannen nach dem Filtern im OSGP-Index. | | `accessPathSearches` | Anzahl der Zugriffspfadsuchen. | | `fullyBoundedAccessPathSearches` | Anzahl der Suchen nach vollständig begrenzten Schlüsselzugriffspfaden. | | `accessPathSearchedByPrefix` | Anzahl der Zugriffspfadsuchen nach Präfix. | | `searchesWhereRecordsWereFound` | Anzahl der Suchen, bei denen 1 oder mehrere Datensätze ausgegeben wurden. | | `searchesWhereRecordsWereNotFound` | Anzahl der Suchen, bei denen keine Datensätze ausgegeben wurden. | | `totalRecordsFoundInSearches` | Gesamtzahl der bei allen Suchen gefundenen Datensätze. | | `statementsInsertedInAllIndexes` | Anzahl der in allen Indizes eingefügten Anweisungen. | | `statementsUpdatedInAllIndexes` | Anzahl der in allen Indizes aktualisierten Anweisungen. | | `statementsDeletedInAllIndexes` | Anzahl der in allen Indizes gelöschten Anweisungen. | | `predicateCount` | Anzahl der Prädikate. | | `dictionaryReadsFromValueToIdTable` | Anzahl der Verzeichnislesevorgänge von der Wert- in die ID-Tabelle. | | `dictionaryReadsFromIdToValueTable` | Anzahl der Verzeichnislesevorgänge von der ID- in die Wert-Tabelle. | | `dictionaryWritesToValueToIdTable` | Anzahl der Verzeichnisschreibvorgänge von der Wert- in die ID-Tabelle. | | `dictionaryWritesToIdToValueTable` | Anzahl der Verzeichnisschreibvorgänge von der ID- in die Wert-Tabelle. | | `rangeCountsInAllIndexes` | Anzahl der Bereichszählungen in allen Indizes. | | `deadlockCount` | Anzahl der Deadlocks in der Abfrage. | | `singleCardinalityInserts` | Anzahl der ausgeführten Einfügungen mit einfacher Kardinalität. | | `singleCardinalityInsertDeletions` | Anzahl der während Einfügungen mit einfacher Kardinalität gelöschten Anweisungen. | | `sharedLocksWaitTimeMillis` | Anzahl der Millisekunden, die damit verbracht wurden, auf gemeinsame Sperren zu warten. | | `exclusiveLocksWaitTimeMillis` | Anzahl der Millisekunden, die damit verbracht wurden, auf exklusive Sperren zu warten. | ## Beispiel für die Debug-Protokollierung einer langsamen Abfrage Die Ausführung der folgenden Gremlin-Abfrage könnte länger dauern als der für langsame Abfragen festgelegte Schwellenwert: ``` gremlin=g.V().has('code','AUS').repeat(out().simplePath()).until(has('code','AGR')).path().by('code').limit(20).fold() ``` Wenn die Protokollierung langsamer Abfragen im Debug-Modus aktiviert wäre, würden die folgenden Attribute für die Abfrage in einem Format wie dem folgenden protokolliert: ``` { "requestResponseMetadata": { "requestId": "5311e493-0e98-457e-9131-d250a2ce1e12", "requestType": "HTTP_GET", "responseStatusCode": 200 }, "queryStats": { "query": "gremlin=g.V().has('code','AUS').repeat(out().simplePath()).until(has('code','AGR')).path().by('code').limit(20).fold()", "queryFingerprint": "g.V().has(string0,string1).repeat(__.out().simplePath()).until(__.has(string0,string2)).path().by(string0).limit(long0).fold()", "queryLanguage": "Gremlin" }, "memoryStats": { "allocatedPermits": 20, "approximateUsedMemoryBytes": 14838 }, "queryTimeStats": { "startTime": "23/02/2023 11:42:52.657", "overallRunTimeMs": 2249, "executionTimeMs": 2229, "serializationTimeMs": 13 }, "statementCounters": { "read": 69979 }, "transactionCounters": { "committed": 1 }, "concurrentExecutionStats": { "acceptedQueryCountAtStart": 1 }, "queryBatchStats": { "queryProcessingBatchSize": 1000, "querySerialisationBatchSize": 1000 }, "storageCounters": { "statementsScannedInAllIndexes": 69979, "statementsScannedSPOGIndex": 44936, "statementsScannedPOGSIndex": 4, "statementsScannedGPSOIndex": 25039, "statementsReadInAllIndexes": 68566, "statementsReadSPOGIndex": 43544, "statementsReadPOGSIndex": 2, "statementsReadGPSOIndex": 25020, "accessPathSearches": 27, "fullyBoundedAccessPathSearches": 27, "dictionaryReadsFromValueToIdTable": 10, "dictionaryReadsFromIdToValueTable": 17, "rangeCountsInAllIndexes": 4, "sharedLocksWaitTimeMillis": 0, "exclusiveLocksWaitTimeMillis": 0 } } ``` # Protokollieren Amazon Neptune Neptune-API-Aufrufen mit AWS CloudTrail Amazon Neptune ist in einen Service integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die von einem Benutzer, einer Rolle oder einem AWS Service in Neptune ausgeführt wurden. CloudTrail erfasst API-Aufrufe für Neptune als Ereignisse, einschließlich Aufrufe von der Neptun-Konsole und von Codeaufrufen an Neptune. APIs CloudTrail protokolliert nur Ereignisse für Neptune Management API-Aufrufe, z. B. das Erstellen einer Instanz oder eines Clusters. Wenn Sie Änderungen an Ihrem Graph prüfen möchten, können Sie dazu Audit-Protokolle verwenden. Weitere Informationen finden Sie unter [Verwenden von Prüfprotokollen mit Amazon-Neptune-Clustern](auditing.md). **Wichtig** Amazon Neptune Neptune-Konsolen AWS CLI- und API-Aufrufe werden als Aufrufe an die Amazon Relational Database Service (Amazon RDS) -API protokolliert. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Übermittlung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für Neptune. 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 CloudTrail, die an Neptune gestellt wurde, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details ermitteln. Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). # Neptun-Informationen in CloudTrail CloudTrail ist in Ihrem AWS Konto aktiviert, wenn Sie das Konto erstellen. Wenn in Amazon Neptune eine Aktivität auftritt, wird diese Aktivität zusammen mit anderen AWS Serviceereignissen in der CloudTrail Ereignishistorie 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 Neptune, erstellen Sie einen Trail. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie ein Trail in der Konsole anlegen, gilt dieser für alle Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen 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 unter: + [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail Unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Wenn im Namen Ihres AWS Kontos über die Neptune-Konsole, die Neptune-Befehlszeilenschnittstelle oder das Neptune-SDK APIs Neptune Aktion ausgeführt wird, wird die Aktion als Aufrufe an die AWS CloudTrail Amazon RDS-API protokolliert. Wenn Sie beispielsweise die Neptune-Konsole verwenden, um eine DB-Instance zu ändern oder den AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/neptune/modify-db-instance.html)Befehl aufzurufen, zeigt das AWS CloudTrail Protokoll einen Aufruf der Amazon RDS-API-Aktion [Modify DBInstance](API_ModifyDBInstance.html). Eine Liste der Neptune-API-Aktionen, die protokolliert werden AWS CloudTrail, finden Sie in der [Neptune-API-Referenz](neptune-api-reference.html). **Anmerkung** AWS CloudTrail protokolliert nur Ereignisse für Neptune Management API-Aufrufe, z. B. das Erstellen einer Instanz oder eines Clusters. Wenn Sie Änderungen an Ihrem Graph prüfen möchten, können Sie dazu Audit-Protokolle verwenden. Weitere Informationen finden Sie unter [Verwenden von Prüfprotokollen mit Amazon-Neptune-Clustern](auditing.md). 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: + Gibt an, ob die Anforderung mit Root- oder IAM-Benutzer-Anmeldeinformationen ausgeführt wurde. + Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde. + Ob die Anfrage von einem anderen AWS Dienst gestellt wurde. Weitere Informationen finden Sie unter [CloudTrail userIdentity-Element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). # Neptune-Protokolldateieinträge verstehen 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 stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden. Das folgende Beispiel zeigt ein CloudTrail Protokoll für einen Benutzer, der einen Snapshot einer DB-Instance erstellt und diese Instance dann mit der Neptune-Konsole gelöscht hat. Die Konsole wird durch das Element `userAgent` identifiziert. Die angeforderten API-Aufrufe, die von der Konsole gemacht wurden (`CreateDBSnapshot` und `DeleteDBInstance`) sind im Element `eventName` in jedem Eintrag zu finden. Informationen zum Benutzer (`Alice`) finden Sie im `userIdentity`-Element. ``` { Records:[ { "awsRegion":"us-west-2", "eventName":"CreateDBSnapshot", "eventSource":"domainSource", "eventTime":"2014-01-14T16:23:49Z", "eventVersion":"1.0", "sourceIPAddress":"192.0.2.01", "userAgent":"AWS Console, aws-sdk-java\/unknown-version Linux\/2.6.18-kaos_fleet-1108-prod.2 Java_HotSpot(TM)_64-Bit_Server_VM\/24.45-b08", "userIdentity": { "accessKeyId":"0123456789012", "accountId":"123456789012", "arn":"arn:aws:iam::123456789012:user/Alice", "principalId":"AIDAI2JXM4FBZZEXAMPLE", "sessionContext": { "attributes": { "creationDate":"2014-01-14T15:55:59Z", "mfaAuthenticated":false } }, "type":"IAMUser", "userName":"Alice" } }, { "awsRegion":"us-west-2", "eventName":"DeleteDBInstance", "eventSource":"domainSource", "eventTime":"2014-01-14T16:28:27Z", "eventVersion":"1.0", "sourceIPAddress":"192.0.2.01", "userAgent":"AWS Console, aws-sdk-java\/unknown-version Linux\/2.6.18-kaos_fleet-1108-prod.2 Java_HotSpot(TM)_64-Bit_Server_VM\/24.45-b08", "userIdentity": { "accessKeyId":"0123456789012", "accountId":"123456789012", "arn":"arn:aws:iam::123456789012:user/Alice", "principalId":"AIDAI2JXM4FBZZEXAMPLE", "sessionContext": { "attributes": { "creationDate":"2014-01-14T15:55:59Z", "mfaAuthenticated":false } }, "type":"IAMUser", "userName":"Alice" } } ] } ``` # Verwenden von Neptune-Ereignisbenachrichtigungen **Topics** + [Ereigniskategorien und Ereignismeldungen in Amazon Neptune](event-lists.md) + [Abonnieren von Neptune-Ereignisbenachrichtigungen](events-subscribing.md) + [Verwalten von Abonnements für Neptune-Ereignisbenachrichtigungen](events-manage.md) Amazon Neptune nutzt Amazon Simple Notification Service (Amazon SNS), um bei Neptune-Ereignissen Benachrichtigungen zu senden. Diese Benachrichtigungen können in jeder Form erfolgen, die von Amazon SNS für eine AWS Region unterstützt wird, z. B. eine E-Mail, eine Textnachricht oder ein Anruf an einen HTTP-Endpunkt. Neptune gruppiert diese Ereignisse nach Kategorien, die Sie abonnieren können, um bei einem Ereignis in diesen Kategorien benachrichtigt zu werden. Sie können eine Ereigniskategorie für eine DB-Instance, einen DB-Cluster, einen DB-Snapshot, einen DB-Cluster-Snapshot oder eine DB-Parametergruppe abonnieren. Wenn Sie beispielsweise die Kategorie „Backup“ für eine bestimmte DB-Instance abonnieren, werden Sie benachrichtigt, sobald ein sicherungsbezogenes Ereignis auftritt, das sich auf Ihre DB-Instance auswirkt. Außerdem erhalten Sie eine Benachrichtigung, wenn ein Abonnement für Ereignisbenachrichtigungen geändert wird. Ereignisse treten auf DB-Cluster- und DB-Instance-Ebene auf. Daher erhalten Sie Ereignisse, wenn Sie einen DB-Cluster oder eine DB-Instance abonnieren. Ereignisbenachrichtigungen werden an die Adressen gesendet, die Sie bei Erstellung des Abonnements angegeben haben. Sie sollten mehrere verschiedene Abonnements erstellen, beispielsweise ein Abonnement für alle Ereignisbenachrichtigungen und ein anderes Abonnement für kritische Ereignisse bei Produktions-DB-Instances. Sie können die Benachrichtigungen ganz einfach deaktivieren, ohne ein Abonnement zu löschen. Hierzu legen Sie in der Neptune-Konsole das Optionsfeld **Aktiviert** auf **Nein** fest. **Wichtig** Amazon Neptune garantiert nicht die Reihenfolge der Ereignisse, die in einem Ereignis-Stream gesendet werden. Die Reihenfolge der Ereignisse kann sich ändern. Neptune verwendet den Amazon-Ressourcennamen (ARN) eines Amazon-SNS-Themas, um die einzelnen Abonnements zu ermitteln. Die Neptune-Konsole erstellt einen ARN für Sie, wenn Sie ein Abonnement erstellen. Die Abrechnung Neptune-Ereignisbenachrichtigungen erfolgt über Amazon SNS. Bei Verwendung von Ereignisbenachrichtigungen fallen Amazon-SNS-Gebühren an. Weitere Informationen finden Sie unter [Preise für den Amazon Simple Notification Service (SNS)](https://aws.amazon.com/sns/#pricing). # Ereigniskategorien und Ereignismeldungen in Amazon Neptune Neptune generiert eine erhebliche Anzahl von Ereignissen in Kategorien, die Sie über die Neptune-Konsole abonnieren können. Jede Kategorie gilt für einen Quelltyp, der eine DB-Instance, ein DB-Snapshot oder eine DB-Parametergruppe sein kann. **Anmerkung** Neptune verwendet bestehende Amazon RDS-Ereignisdefinitionen und. IDs ## Neptune-Ereignisse aus DB-Instances Die folgende Tabelle zeigt eine Liste von Ereignissen nach Ereigniskategorie, wenn der Quelltyp eine DB-Instance ist. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/event-lists.html) ## Neptune-Ereignisse aus einem DB-Cluster Die folgende Tabelle zeigt eine Liste von Ereignissen nach Ereigniskategorie, wenn der Quelltyp ein DB-Cluster ist. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/event-lists.html) ## Neptune-Ereignisse aus einem DB-Cluster-Snapshot Die folgende Tabelle zeigt die Ereigniskategorie und eine Liste von Ereignissen, wenn der Quelltyp ein Neptune-DB-Cluster-Snapshot ist. | Kategorie | RDS-Ereignis-ID | Beschreibung | | --- | --- | --- | | Backup | RDS-EVENT-0074 | Die Erstellung eines manuellen DB-Cluster-Snapshots hat begonnen. | | Backup | RDS-EVENT-0075 | Ein manueller DB-Cluster-Snapshot wurde erstellt. | | Benachrichtigung | RDS-EVENT-0162 | Fehler beim Exportieren von DB-Cluster-Snapshots. | | Benachrichtigung | RDS-EVENT-0163 | DB-Cluster-Snapshot-Exportaufgabe abgebrochen. | | Benachrichtigung | RDS-EVENT-0164 | DB-Cluster-Snapshot-Exportaufgabe abgeschlossen. | | Backup | RDS-EVENT-0168 | Erstellen eines automatisierten Cluster-Snapshots. | | Backup | RDS-EVENT-0169 | Automatisierter Cluster-Snapshot erstellt. | | Erstellung | RDS-EVENT-0170 | DB-Cluster erstellt. | | Löschung | RDS-EVENT-0171 | DB-Cluster gelöscht. | | Benachrichtigung | RDS-EVENT-0172 | DB-Cluster von [alter DB-Cluster-Name] in [neuer DB-Cluster-Name] umbenannt. | ## Neptune-Ereignisse aus einer DB-Cluster-Parametergruppe Die folgende Tabelle zeigt die Ereigniskategorie und eine Liste von Ereignissen, wenn der Quelltyp eine DB-Cluster-Parametergruppe ist. | Kategorie | RDS-Ereignis-ID | Beschreibung | | --- | --- | --- | | Konfigurationsänderung | RDS-EVENT-0037 | Die Parametergruppe wurde geändert. | ## Neptune-Ereignisse aus einer Sicherheitsgruppe Die folgende Tabelle zeigt die Ereigniskategorie und eine Liste von Ereignisse, wenn der Quelltyp eine Sicherheitsgruppe ist. | Kategorie | RDS-Ereignis-ID | Beschreibung | | --- | --- | --- | | Konfigurationsänderung | RDS-EVENT-0038 | Die Sicherheitsgruppe wurde geändert. | | Ausfall | RDS-EVENT-0039 | Die Sicherheitsgruppe, deren Besitzer [Benutzer] ist, existiert nicht. Die Autorisierung für diese Sicherheitsgruppe wurde widerrufen. | # Abonnieren von Neptune-Ereignisbenachrichtigungen Sie können die Neptune-Konsole verwenden, um Ereignisbenachrichtigungen wie folgt zu abonnieren: **So abonnieren Sie Neptune-Ereignisbenachrichtigungen** 1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Neptune Neptune-Konsole zu Hausehttps://console.aws.amazon.com/neptune/.](https://console.aws.amazon.com/neptune/home) 1. Wählen Sie im Navigationsbereich **Ereignisabonnements** aus. 1. Wählen Sie im Bereich **Ereignisabonnements** **Ereignisabonnement erstellen** aus. 1. Gehen Sie im Dialogfeld **Ereignisabonnement erstellen** wie folgt vor: 1. Geben Sie unter **Name** einen Namen für das Abonnement für Ereignisbenachrichtigungen ein. 1. Wählen Sie unter **Send notifications to (Benachrichtigungen senden an)** einen vorhandenen Amazon SNS-ARN für ein Amazon SNS-Thema oder wählen Sie **create topic (Thema erstellen)**, um den Namen für ein Thema und eine Liste von Empfängern anzugeben. 1. Wählen Sie unter **Quelltyp** einen Quelltyp aus. 1. Wählen Sie **Ja** aus, um das Abonnement zu aktivieren. Wenn Sie das Abonnement erstellen möchten, jedoch noch keine Benachrichtigungen gesendet haben, wählen Sie **Nein** aus. 1. Wählen Sie abhängig vom ausgewähltem Quelltyp die Ereigniskategorien und Quellen aus, für die Sie Ereignisbenachrichtigungen erhalten möchten. 1. Wählen Sie **Erstellen** aus. # Verwalten von Abonnements für Neptune-Ereignisbenachrichtigungen Wenn Sie im Navigationsbereich der Neptune-Konsole **Ereignisbenachrichtigungen** auswählen, können Sie Abonnementkategorien und die Liste aktueller Abonnements anzeigen. Sie können auch ein bestimmtes Abonnement ändern oder löschen. ## Ändern von Abonnements für Neptune-Ereignisbenachrichtigungen **Ändern aktueller Abonnements für Neptune-Ereignisbenachrichtigungen** 1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Neptune Neptune-Konsole zu Hausehttps://console.aws.amazon.com/neptune/.](https://console.aws.amazon.com/neptune/home) 1. Wählen Sie im Navigationsbereich **Ereignisabonnements** aus. Im Bereich **Ereignisabonnements** werden all Ihre Abonnements für Ereignisbenachrichtigungen angezeigt. 1. Wählen Sie im Bereich **Ereignisabonnements** das Abonnement, das Sie modifizieren möchten, und klicken Sie auf **Bearbeiten**. 1. Nehmen Sie Ihre Änderungen am Abonnement im Bereich **Ziel** oder **Quelle** vor. Sie können Quell-IDs hinzufügen oder entfernen, indem Sie diese im Bereich **Quelle** auswählen oder ihre Auswahl aufheben. 1. Wählen Sie **Bearbeiten** aus. Die Neptune-Konsole zeigt an, dass das Abonnement geändert wurde. ## Löschen von Abonnements für Neptune-Ereignisbenachrichtigungen Sie können ein Abonnement löschen, wenn Sie es nicht mehr benötigen. Alle Abonnenten des Themas erhalten dann keine weiteren Ereignisbenachrichtigungen, die über dieses Abonnement ausgegeben wurden. **Löschen eines Abonnements für Neptune-Ereignisbenachrichtigungen** 1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Neptune Neptune-Konsole zu Hausehttps://console.aws.amazon.com/neptune/.](https://console.aws.amazon.com/neptune/home) 1. Wählen Sie im Navigationsbereich **Ereignisabonnements** aus. 1. Wählen Sie im Bereich **Ereignisabonnements** das Abonnement aus, das Sie löschen möchten. 1. Wählen Sie **Löschen** aus. 1. Die Neptune-Konsole zeigt an, dass das Abonnement gelöscht wurde. # Taggen von Amazon Neptune Neptune-Ressourcen Sie können mit Neptune-Tags Metadaten zu Neptune-Ressourcen hinzufügen. Darüber hinaus können Sie Tags mit AWS Identity and Access Management (IAM-) Richtlinien verwenden, um den Zugriff auf Neptune-Ressourcen zu verwalten und zu kontrollieren, welche Aktionen auf diese Ressourcen angewendet werden können. Außerdem können Sie mit Tags auch Kosten verfolgen, indem Ausgaben für ähnlich getaggte Ressourcen gruppiert werden. Alle Neptune-Verwaltungsressourcen können getaggt werden, einschließlich der folgenden: + DB-Instances + DB-Cluster + Read Replicas + DB-Snapshots + DB-Cluster-Snapshots + Ereignisabonnements + DB-Parametergruppen + DB-Cluster-Parametergruppen + DB-Subnetzgruppen ## Überblick über Neptun-Ressourcen-Tags Ein Amazon-Neptune-Tag ist ein Name-Wert-Paar, das Sie definieren und mit einer Neptune-Ressource verknüpfen. Der Name wird als der *Schlüssel* bezeichnet. Die Angabe eines Wertes für den Schlüssel ist optional. Sie können mit Tags einer Neptune-Ressource Informationen zuweisen. Sie können einen Tag-Schlüssel z. B. dazu verwenden, um eine Kategorie zu definieren, und ein Tag-Wert könnte ein Element in dieser Kategorie sein. Sie könnten beispielsweise den Tag-Schlüssel „Projekt“ und den Tag-Wert „Salix“ definieren. Das bedeutet, dass die Neptune-Ressource dem Projekt „Salix“ zugewiesen ist. Sie können mit Tags Neptune-Ressourcen auch als Test- oder Produktionsressourcen bezeichnen, indem Sie einen Schlüssel wie `environment=test` oder `environment=production` verwenden. Wir empfehlen die Verwendung eines konsistenten Satzes von Tag-Schlüsseln, um die mit Neptune-Ressourcen verknüpften Metadaten einfacher verfolgen zu können. Verwenden Sie Tags, um Ihre AWS Rechnung so zu organisieren, dass sie Ihrer eigenen Kostenstruktur entspricht. Melden Sie sich dazu an, um Ihre AWS-Konto Rechnung mit den Tag-Schlüsselwerten zu erhalten. Um dann die Kosten kombinierter Ressourcen anzuzeigen, organisieren Sie Ihre Fakturierungsinformationen nach Ressourcen mit gleichen Tag-Schlüsselwerten. Beispielsweise können Sie mehrere Ressourcen mit einem bestimmten Anwendungsnamen markieren und dann Ihre Fakturierungsinformationen so organisieren, dass Sie die Gesamtkosten dieser Anwendung über mehrere Services hinweg sehen können. Weitere Informationen finden Sie unter [Verwendung von Kostenzuordnungs-Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) im *AWS Billing -Benutzerhandbuch*. Jede Neptune-Ressource besitzt einen Tag-Satz, der alle Tags enthält, die dieser Neptune-Ressource zugewiesen sind. Ein Tag-Satz kann bis zu zehn Tags enthalten oder leer sein. Wenn Sie einer Neptune-Ressource ein Tag hinzufügen, das denselben Schlüssel wie ein bereits vorhandenes Tag der Ressource hat, überschreibt der neue Wert den alten Wert. AWS weist Ihren Tags keine semantische Bedeutung zu; Tags werden ausschließlich als Zeichenketten interpretiert. Neptune kann Tags für eine DB-Instance oder andere Neptune-Ressourcen festlegen, abhängig von den Einstellungen, die Sie beim Erstellen der Ressource verwenden. Beispielsweise kann Neptune ein Tag hinzufügen, das eine DB-Instance als Produktions- oder Testressource kennzeichnet. + Der Tag-Schlüssel ist der erforderliche Name des Tags. Der Zeichenfolgenwert kann aus 1 bis 128 Unicode-Zeichen bestehen. Ihm darf kein "`aws:`" oder "`rds:`" als Präfix vorangestellt werden. Die Zeichenfolge darf nur Unicode-Zeichen, Ziffern, Leerzeichen sowie '\$1', '.', '/', '=', '\$1', '-' enthalten (Java-Regex: "`^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$`"). + Der Tag-Wert ist ein optionaler Zeichenfolgenwert des Tags. Der Zeichenfolgenwert kann aus 1 bis 256 Unicode-Zeichen bestehen. Ihm darf kein "`aws:`" als Präfix vorangestellt werden. Die Zeichenfolge darf nur Unicode-Zeichen, Ziffern, Leerzeichen sowie '\$1', '.', '/', '=', '\$1', '-' enthalten (Java-Regex: "`^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$`"). Die Werte innerhalb eines Tag-Satzes müssen nicht eindeutig und können null sein. Es ist z. B. ein Schlüssel-Wert-Paar in einem Tag-Satz `project/Trinity` und `cost-center/Trinity` möglich. **Anmerkung** Sie können einem Snapshot ein Tag hinzufügen. Diese Gruppierung erscheint jedoch nicht in Ihrer Rechnung. Sie können die AWS-Managementkonsole, oder die Neptune-API verwenden AWS CLI, um Tags zu Neptune-Ressourcen hinzuzufügen, aufzulisten und zu löschen. Wenn Sie die AWS CLI oder die Neptune-API verwenden, müssen Sie den Amazon-Ressourcennamen (ARN) für die Neptune-Ressource angeben, mit der Sie arbeiten möchten. Weitere Informationen zum Konstruieren eines ARN finden Sie unter [Konstruieren eines ARN für Neptune](tagging-arns-constructing.md). Tags werden für Autorisierungszwecke im Cache gespeichert. Daher kann es einige Minuten dauern, bis Ergänzungen und Aktualisierungen für Tags von Neptune-Ressourcen verfügbar sind. ### Tags in Neptune kopieren Wenn Sie eine DB-Instance erstellen oder wiederherstellen, können Sie festlegen, dass die Tags aus der DB-Instance in Snapshots der DB-Instance kopiert werden. Das Kopieren von Tags stellt sicher, dass die Metadaten für die DB-Snapshots mit denen der Quell-DB-Instance übereinstimmen und alle vordefinierten Zugriffsrichtlinien für die DB-Instance denen der Quell-DB-Instance entsprechen. Tags werden nicht standardmäßig kopiert. Sie können für die folgenden Aktionen festlegen, dass Tags in DB-Snapshots kopiert werden: + Erstellen einer DB-Instance + Wiederherstellen einer DB-Instance + Erstellen eines Read Replicas + Kopieren eines DB-Snapshots **Anmerkung** Wenn Sie einen Wert für den `--tag-key` Parameter des [create-db-cluster-snapshot](https://docs.aws.amazon.com/cli/latest/reference/neptune/create-db-cluster-snapshot.html) AWS CLI Befehls angeben (oder mindestens ein Tag für die [DBClusterSnapshot erstellen](api-snapshots.md#CreateDBClusterSnapshot) API-Aktion angeben), kopiert Neptune keine Tags von der Quell-DB-Instance in den neuen DB-Snapshot. Dies gilt auch dann, wenn in der Quell-DB-Instance die Option `--copy-tags-to-snapshot` (`CopyTagsToSnapshot`) aktiviert ist. Sie können also eine Kopie einer DB-Instance aus einen DB-Snapshot erstellen und vermeiden, Tags hinzuzufügen, die nicht für die neue DB-Instance gelten. Nachdem Sie Ihren DB-Snapshot mit dem AWS CLI `create-db-cluster-snapshot` Befehl (oder der `CreateDBClusterSnapshot` Neptune-API-Aktion) erstellt haben, können Sie Tags hinzufügen, wie später in diesem Thema beschrieben. # Taggen in Neptune mit dem AWS-Managementkonsole Amazon-Neptune-Ressourcen werden alle auf ähnliche Weise markiert. Das folgende Verfahrezn zeigt das Markieren einer Neptune-DB-Instance. **So fügen Sie ein Tag zu einer DB-Instance hinzu** 1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Neptune Neptune-Konsole zu Hausehttps://console.aws.amazon.com/neptune/.](https://console.aws.amazon.com/neptune/home) 1. Wählen Sie im Navigationsbereich **Instances** aus. **Anmerkung** Geben Sie im Bereich **Instances** im Feld **Filter instances** (Instances filtern) eine Textzeichenfolge ein, um die Liste der DB-Instances zu filtern. Es werden nur DB-Instances angezeigt, welche die Zeichenfolge enthalten. 1. Wählen Sie die DB-Instance aus, die getaggt werden soll. 1. Wählen Sie **Instance actions** und dann **See details** aus. 1. Scrollen Sie im Detailbereich nach unten zum Bereich **Tags**. 1. Wählen Sie **Add** aus. Das Fenster **Add tags** (Tags hinzufügen) wird angezeigt. 1. Geben Sie einen Wert für **Tag key** (Tag-Schlüssel) und **Value** (Wert) ein. 1. Wenn Sie ein weiteres Tag hinzufügen möchten, klicken Sie auf **Add another Tag** (Weiteres Tag hinzufügen) und geben Sie einen Wert für **Tag key** (Tag-Schlüssel) und **Value** (Wert) ein. Wiederholen Sie diesen Schritt, bis Sie alle Tags hinzugefügt haben. 1. Wählen Sie **Add** aus. **So löschen Sie ein Tag aus einer DB-Instance** 1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Neptune Neptune-Konsole zu Hausehttps://console.aws.amazon.com/neptune/.](https://console.aws.amazon.com/neptune/home) 1. Wählen Sie im Navigationsbereich **Instances** aus. **Anmerkung** Geben Sie im Bereich **Instances** im Feld **Filter instances** (Instances filtern) eine Textzeichenfolge ein, um die Liste der DB-Instances zu filtern. Es werden nur DB-Instances angezeigt, welche die Zeichenfolge enthalten. 1. Wählen Sie die DB-Instance aus, die getaggt werden soll. 1. Wählen Sie **Instance actions** und dann **See details** aus. 1. Scrollen Sie im Detailbereich nach unten zum Bereich **Tags**. 1. Wählen Sie das Tag aus, das Sie löschen möchten. 1. Klicken Sie auf **Remove** (Entfernen) und dann im Fenster **Remove tags** (Tags entfernen) auf **Remove** (Entfernen). # Taggen in Neptune mit dem AWS CLI Über die AWS CLI können Sie Tags für eine DB-Instance in Neptune hinzufügen, auflisten oder entfernen. + Verwenden Sie den Befehl, um einer Neptun-Ressource ein oder mehrere Tags hinzuzufügen. AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/neptune/add-tags-to-resource.html](https://docs.aws.amazon.com/cli/latest/reference/neptune/add-tags-to-resource.html) + Verwenden Sie den Befehl, um die Tags einer Neptun-Ressource aufzulisten. AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/neptune/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/neptune/list-tags-for-resource.html) + Verwenden Sie den Befehl, um ein oder mehrere Tags aus einer Neptun-Ressource zu entfernen. AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/neptune/remove-tags-from-resource.html](https://docs.aws.amazon.com/cli/latest/reference/neptune/remove-tags-from-resource.html) Weitere Informationen zum Erstellen des erforderlichen Amazon-Ressourcennamens (ARN) finden Sie unter [Konstruieren eines ARN für Neptune](tagging-arns-constructing.md). # Taggen in Neptune mithilfe der API Über die Neptune-API können Sie Tags für eine DB-Instance hinzufügen, auflisten oder entfernen. + Um einen Tag zu einer Neptune-Ressource hinzuzufügen, verwenden Sie die Operation [API_AddTagsToResource.html](API_AddTagsToResource.html). + Um die Tags für eine Neptune-Ressource aufzulisten, verwenden Sie die Operation [API_ListTagsForResource.html](API_ListTagsForResource.html). + Um Tags aus einer Neptune-Ressource zu entfernen, verwenden Sie die Operation [API_RemoveTagsFromResource.html](API_RemoveTagsFromResource.html). Weitere Informationen zum Konstruieren des erforderlichen ARN finden Sie unter [Konstruieren eines ARN für Neptune](tagging-arns-constructing.md). Beim Arbeiten mit XML über die Neptune-API verwenden Tags das folgende Schema: ``` 1. 2. 3. 4. Project 5. Trinity 6. 7. 8. User 9. Jones 10. 11. 12. ``` Die folgende Tabelle enthält eine Liste der zulässigen XML-Tags und deren Eigenschaften. Bei den Werten für `Key` und `Value` muss zwischen Klein- und Großbuchstaben unterschieden werden. Beispiel: `project=Trinity` und `PROJECT=Trinity` sind zwei verschiedene Tags. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/tagging-api.html) # Arbeiten mit administrativen Funktionen ARNs in Amazon Neptune In Amazon Web Services erstellte Ressourcen werden anhand eines Amazon-Ressourcennamens (ARN) eindeutig identifiziert. Für bestimmte Amazon-Neptune-Operationen müssen Sie Neptune-Ressourcen eindeutig identifizieren, indem Sie ihren ARN angeben. **Wichtig** Amazon Neptune teilt das Format von Amazon RDS ARNs für administrative Aktionen, die das verwenden. [Management-API-Referenz](api.md) Neptune administrativ ARNs enthalten `rds` und nicht. `neptune-db` Informationen zur Datenebene ARNs , die Neptun-Datenressourcen identifizieren, finden Sie unter Datenressourcen [angeben](iam-data-resources.md). **Topics** + [Konstruieren eines ARN für Neptune](tagging-arns-constructing.md) + [Einen vorhandenen ARN in Amazon Neptune abrufen](#tagging-arns-getting) # Konstruieren eines ARN für Neptune Sie können mithilfe der folgenden Syntax einen ARN für eine Amazon-Neptune-Ressource konstruieren. Beachten Sie, dass Neptune das Format von Amazon RDS teilt. ARNs `arn:aws:rds::::` Die folgende Tabelle zeigt das Format, das Sie beim Konstruieren eines ARN für einen bestimmten administrativen Neptune-Ressourcentyp verwenden sollten. **** | Ressourcentyp | ARN-Format | | --- | --- | | DB-Instance | arn:aws:rds:: ** ** `:db:` ** Beispiel: 
arn:aws:rds:us-east-2:123456789012:db:my-instance-1
| | DB-Cluster | arn:aws:rds:**: ** `:cluster:` ** Beispiel: 
arn:aws:rds:us-east-2:123456789012:cluster:my-cluster-1
| | Ereignisabonnement | arn:aws:rds:**: ** `:es:` ** Beispiel: 
arn:aws:rds:us-east-2:123456789012:es:my-subscription
| | DB-Parametergruppe | arn:aws:rds:**: ** `:pg:` ** Beispiel: 
arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs
| | DB-Cluster-Parametergruppe | arn:aws:rds:**: ** `:cluster-pg:` ** Beispiel: 
arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone
| | DB-Cluster-Snapshot | arn:aws `rds:`**: ** `:cluster-snapshot:` ** Beispiel: 
arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-snap-20160809
| | DB-Subnetzgruppe | arn:aws: `rds:` ** ** `:subgrp:` ** Beispiel: 
arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10
| ## Einen vorhandenen ARN in Amazon Neptune abrufen Sie können den ARN einer Neptun-Ressource mithilfe der AWS-Managementkonsole, AWS Command Line Interface (AWS CLI) oder Neptune-API abrufen. ### Abrufen eines vorhandenen ARN mit dem AWS-Managementkonsole Um einen ARN über die Konsole abzurufen, navigieren Sie zu der Ressource, für die Sie einen ARN erhalten möchten, und zeigen Sie die Details für diese Ressource an. Zum Abrufen des ARN für eine DB-Instance, wählen Sie z. B. **Instances** im Navigationsbereich und dann die gewünschte Instance aus der Liste aus. Der ARN befindet sich im Bereich **Instance Details** (Instance-Details). ### Abrufen eines vorhandenen ARN mit dem AWS CLI Um den zu verwenden AWS CLI , um einen ARN für eine bestimmte Neptun-Ressource zu erhalten, verwenden Sie den `describe` Befehl für diese Ressource. Die folgende Tabelle zeigt jeden AWS CLI Befehl und die ARN-Eigenschaft, die zusammen mit dem Befehl verwendet wird, um einen ARN abzurufen. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/tagging-arns.html) Mit dem folgenden AWS CLI Befehl wird beispielsweise der ARN für eine DB-Instance abgerufen. **Example** Für Linux, OS X oder Unix: ``` 1. aws neptune describe-db-instances \ 2. --db-instance-identifier DBInstanceIdentifier \ 3. --region us-west-2 ``` Für Windows: ``` 1. aws neptune describe-db-instances ^ 2. --db-instance-identifier DBInstanceIdentifier ^ 3. --region us-west-2 ``` ### Einen vorhandenen ARN mithilfe der API abrufen Um einen ARN für eine bestimmte Neptune-Ressource abzurufen, rufen Sie die folgenden API-Aktionen auf und verwenden die angezeigten ARN-Eigenschaften. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/tagging-arns.html)