Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Monitoraggio delle risorse di Amazon Neptune Amazon Neptune supporta vari metodi per il monitoraggio delle prestazioni e dell'utilizzo del database: + **Stato dell'istanza**: controlla lo stato del motore di database a grafo di un cluster Neptune, scopri quale versione del motore è installata e ottieni altre informazioni sull'istanza utilizzando l'[API dello stato dell'istanza](access-graph-status.md). + **API di riepilogo del grafo**: l'[API di riepilogo del grafo](neptune-graph-summary.md) consente di ottenere rapidamente una comprensione di alto livello della dimensione e del contenuto dei dati del grafo. **Nota** Poiché l'API di riepilogo del grafo si basa sulle [statistiche DFE](neptune-dfe-statistics.md), è disponibile solo quando le statistiche sono abilitate, il che non è il caso dei tipi di istanza T3 e T4g. + **Amazon CloudWatch** — Neptune invia automaticamente le metriche e supporta anche gli CloudWatch allarmi. CloudWatch Per ulteriori informazioni, consulta [Monitoraggio di Neptune tramite Amazon CloudWatch](cloudwatch.md). + **File di log di audit**: puoi visualizzare, scaricare o controllare i file di log del database tramite la console. Per ulteriori informazioni, consulta [Utilizzo dei log di audit con i cluster Amazon Neptune](auditing.md). + **Pubblicazione dei log su Amazon CloudWatch Logs**: puoi configurare un cluster Neptune DB per pubblicare i dati dei log di controllo in un gruppo di log in Amazon Logs. CloudWatch Con CloudWatch Logs, puoi eseguire analisi in tempo reale dei dati di log, utilizzarli CloudWatch per creare allarmi e visualizzare metriche e utilizzare CloudWatch Logs per archiviare i record di log in uno storage altamente durevole. Per informazioni, consulta [Tronchi di Nettuno CloudWatch ](cloudwatch-logs.md). + **AWS CloudTrail**— Neptune supporta la registrazione delle API utilizzando. CloudTrail Per ulteriori informazioni, consulta [Registrazione delle chiamate API Amazon Neptune con AWS CloudTrail](cloudtrail.md). + **Sottoscrizioni alle notifiche di eventi**: effettua la sottoscrizione agli eventi di Neptune per rimanere informato su ciò che accade. Per ulteriori informazioni, consulta [Utilizzo della notifica di eventi Neptune](events.md). + **Tagging**: usa i tag per aggiungere metadati alle risorse Neptune e monitorare l'utilizzo in base a tag. Per ulteriori informazioni, consulta [Etichettare le risorse di Amazon Neptune](tagging.md). **Topics** + [Controllo dello stato di un’istanza Neptune](access-graph-status.md) + [Monitoraggio di Neptune tramite Amazon CloudWatch](cloudwatch.md) + [Utilizzo dei log di audit con i cluster Amazon Neptune](auditing.md) + [Pubblicazione dei log di Neptune su Amazon Logs CloudWatch](cloudwatch-logs.md) + [Abilitazione di Amazon CloudWatch Logs per un notebook Neptune](notebook-logs.md) + [Utilizzo della registrazione di log delle query lente di Amazon Neptune](slow-query-logs.md) + [Registrazione delle chiamate API Amazon Neptune con AWS CloudTrail](cloudtrail.md) + [Utilizzo della notifica di eventi Neptune](events.md) + [Etichettare le risorse di Amazon Neptune](tagging.md) # Controllo dello stato di un’istanza Neptune Amazon Neptune fornisce un meccanismo per controllare lo stato del database a grafo sull'host. È anche un buon metodo per confermare che sei in grado di connetterti a un’istanza. Per verificare lo stato di integrità di un'istanza e ottenere lo stato del cluster di database utilizzando `curl`: ``` curl -G https://your-neptune-endpoint:port/status ``` Oppure, a partire dal [rilascio del motore 1.2.1.0.R6](engine-releases-1.2.1.0.R6.md), puoi utilizzare il seguente comando della CLI: ``` aws neptunedata get-engine-status ``` Se l'istanza è integra, il comando `status` restituisce un [oggetto JSON](#access-graph-status-sample-output) con i campi seguenti: + **`status`**: impostato su `"healthy"` se l'istanza non presenta problemi. Se l'istanza è in fase di ripristino dopo un arresto anomalo o un riavvio e ci sono transazioni attive in esecuzione dall'ultimo arresto del server, `status` è impostato su `"recovery"`. + **`startTime`**: impostato sull'ora UTC in cui è iniziato il processo del server corrente. + **`dbEngineVersion`**: impostato sulla versione del motore Neptune in esecuzione sul cluster database. Se è stata applicata una patch manualmente a questa versione del motore dopo il rilascio, il numero della versione ha il prefisso `"Patch-"`. + **`role`**: impostato su `"reader"` se l'istanza è una replica di lettura o su `"writer"` se è l'istanza primaria. + **`dfeQueryEngine`**: impostato su `"enabled"` se il [motore DFE](neptune-dfe-engine.md) è completamente abilitato o su `viaQueryHint` se il motore DFE viene utilizzato solo con query per le quali l'hint di query `useDFE` è impostato su `true` (`viaQueryHint` è l'impostazione predefinita). + **`gremlin`**: contiene informazioni sul linguaggio di query Gremlin disponibile nel cluster. In particolare, contiene un `version` campo che specifica la TinkerPop versione corrente utilizzata dal motore. + **`sparql`**: contiene informazioni sul linguaggio di query SPARQL disponibile nel cluster. In particolare, contiene un campo `version` che specifica la versione corrente di SPARQL utilizzata dal motore. + **`opencypher`**: contiene informazioni sul linguaggio di query openCypher disponibile nel cluster. In particolare, contiene un campo `version` che specifica la versione corrente di operCypher utilizzata dal motore. + **`labMode`**: contiene le impostazioni della [Modalità di laboratorio](features-lab-mode.md) utilizzate dal motore. Questo è un elenco selettivo delle impostazioni della modalità Lab e non il set completo. Consultate il [gruppo di parametri del cluster](https://docs.aws.amazon.com//neptune/latest/userguide/parameter-groups.html) per il set completo in uso. + **`rollingBackTrxCount`**: se sono presenti transazioni di cui è stato eseguito il rollback, questo campo è impostato sul numero di tali transazioni. Se non ne esistono, il campo non viene visualizzato. + **`rollingBackTrxEarliestStartTime`**: impostato sull'ora di inizio del rollback della prima transazione. Se non è stato eseguito il rollback di alcuna transazione, il campo non viene visualizzato. + **`features`**: contiene informazioni sullo stato delle funzionalità abilitate nel cluster database. + **`lookupCache`**: stato corrente della [Cache di ricerca](feature-overview-lookup-cache.md). Questo campo viene visualizzato solo per tipi di istanza `R5d`, poiché sono le uniche istanze in cui può esistere una cache di ricerca. Il campo è un oggetto JSON nel formato: ``` "lookupCache": { "status": "current lookup cache status" } ``` Per un'istanza `R5d`: + Se la cache di ricerca è abilitata, lo stato è riportato come `"Available"`. + Se la cache di ricerca è stata disabilitata, lo stato è riportato come `"Disabled"`. + Se è stato raggiunto il limite del disco per l'istanza, lo stato viene riportato come `"Read Only Mode - Storage Limit Reached"`. + **`ResultCache`**: stato corrente della [Memorizzazione nella cache dei risultati delle query](gremlin-results-cache.md). Questo campo è un oggetto JSON nel formato: ``` "ResultCache": { "status": "current results cache status" } ``` + Se la cache dei risultati è stata abilitata, lo stato è riportato come `"Available"`. + Se la cache è disabilitata, lo stato è riportato come `"Disabled"`. + **`IAMAuthentication`**— Speciifica se l'autenticazione AWS Identity and Access Management (IAM) è stata abilitata o meno sul cluster DB: + Se l'autenticazione IAM è stata abilitata, lo stato è riportato come `"enabled"`. + Se l'autenticazione IAM è disabilitata, lo stato è riportato come `"disabled"`. + **`Streams`**: specifica se la funzionalità Neptune Streams è stata abilitata o meno sul cluster database: + Se i flussi sono abilitati, lo stato è riportato come `"enabled"`. + Se i flussi sono disabilitati, lo stato è riportato come `"disabled"`. + **`AuditLog`**: uguale a `enabled` se i log di audit sono abilitati, in caso contrario `disabled`. + **`SlowQueryLogs`**: uguale a `info` o `debug` se la [registrazione di log delle query lente](slow-query-logs.md) è abilitata, in caso contrario `disabled`. + **`QueryTimeout`**: valore, in millisecondi, del timeout delle query. + **`settings`**: impostazioni applicate all'istanza: + **`clusterQueryTimeoutInMs`**: valore, in millisecondi, del timeout delle query, impostato per l'intero cluster. + **`SlowQueryLogsThreshold`**: valore, in millisecondi, del timeout delle query, impostato per l'intero cluster. + **`serverlessConfiguration`**: impostazioni serverless per un cluster se è in esecuzione come serverless: + **`minCapacity`**— La dimensione minima alla quale un'istanza serverless nel cluster DB può ridursi, in Neptune Capacity Units (). NCUs + **`maxCapacity`**— La dimensione massima alla quale può crescere un'istanza serverless nel cluster DB, in Neptune Capacity Units (). NCUs ## Esempio di output del comando instance status Di seguito è riportato un esempio dell'output del comando di stato dell'istanza, (in questo caso, eseguito su un'istanza `R5d`): ``` { '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' } } ``` Se si verifica un problema con l’istanza, il comando di stato restituisce il codice di errore `HTTP 500`. Se l'host non è raggiungibile, la richiesta scade. Verifica di accedere all’istanza dal cloud privato virtuale (VPC, Virtual Private Cloud) e che i gruppi di sicurezza consentano l'accesso. # Monitoraggio di Neptune tramite Amazon CloudWatch Amazon Neptune e CloudWatch Amazon sono integrati in modo da poter raccogliere e analizzare i parametri delle prestazioni. Puoi monitorare questi parametri utilizzando la CloudWatch console, AWS Command Line Interface (AWS CLI) o l'API. CloudWatch CloudWatch consente inoltre di impostare allarmi in modo da poter essere avvisati se un valore metrico supera una soglia specificata. Puoi anche impostare CloudWatch Events per intraprendere azioni correttive in caso di violazione. [Per ulteriori informazioni sull'utilizzo CloudWatch e sugli allarmi, consulta la documentazione. CloudWatch ](https://aws.amazon.com/documentation/cloudwatch) **Topics** + [Visualizzazione CloudWatch dei dati (console)](#Console_Neptune) + [Visualizzazione dei CloudWatch dati ()AWS CLI](#CloudwatchCLI_Neptune) + [Visualizzazione dei dati (API) CloudWatch](#CloudwatchAPI_Neptune) + [Utilizzo CloudWatch per monitorare le prestazioni delle istanze DB in Neptune](cloudwatch-monitoring-instances.md) + [Metriche di Neptune CloudWatch](cw-metrics.md) + [Dimensioni di Nettuno CloudWatch](cw-dimensions.md) ## Visualizzazione CloudWatch dei dati (console) **Per visualizzare CloudWatch i dati per un cluster Neptune (console)** 1. Accedi a Console di gestione AWS e apri la CloudWatch console all'indirizzo. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 1. Nel riquadro di navigazione, seleziona **Parametri**. 1. **Nel riquadro **Tutte le metriche**, scegliete **Neptune**, quindi scegliete Identificatore. DBCluster** 1. Nel riquadro superiore, scorri verso il basso per visualizzare l'elenco completo dei parametri per il cluster. Le opzioni delle metriche Neptune disponibili vengono visualizzate nell'elenco **Visualizzazione**. Per selezionare o deselezionare un singolo parametro, nel riquadro risultati seleziona la casella di controllo accanto al nome della risorsa e al parametro. I grafici che mostrano i parametri per gli elementi selezionati vengono visualizzati nella parte inferiore della console. Per ulteriori informazioni sui CloudWatch grafici, consulta [Graph Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/graph_metrics.html) nella *Amazon CloudWatch User* Guide. ## Visualizzazione dei CloudWatch dati ()AWS CLI **Per visualizzare CloudWatch i dati per un cluster Neptune ()AWS CLI** 1. Installa il. AWS CLI Per istruzioni, consulta la [Guida per l'utente di AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/). 1. Usa il AWS CLI per recuperare informazioni. I CloudWatch parametri rilevanti per Neptune sono elencati in. [Metriche di Neptune CloudWatch](cw-metrics.md) L'esempio seguente recupera le CloudWatch metriche per il numero di richieste Gremlin al secondo per il cluster. `gremlin-cluster` ``` ``` ## Visualizzazione dei dati (API) CloudWatch CloudWatch supporta anche un'`Query`azione che consente di richiedere informazioni a livello di codice. Per ulteriori informazioni, consulta la [documentazione dell'API CloudWatch Query](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/Using_Query_API.html) e [Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/). Quando un' CloudWatch azione richiede un parametro specifico per il monitoraggio di Neptune, ad esempio, utilizzare i `MetricName` valori elencati in. [Metriche di Neptune CloudWatch](cw-metrics.md) L'esempio seguente mostra una CloudWatch richiesta di basso livello, utilizzando i seguenti parametri: + `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` Ecco come si presenta la CloudWatch richiesta. Tuttavia, questo esempio ha solo lo scopo di mostrare il formato della richiesta; dovrai crearne una personalizzata in base ai parametri e all'intervallo temporale da te definiti. ``` 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 ``` # Utilizzo CloudWatch per monitorare le prestazioni delle istanze DB in Neptune Puoi utilizzare le CloudWatch metriche in Neptune per monitorare ciò che accade sulle tue istanze DB e tenere traccia della lunghezza della coda di query osservata dal database. Le metriche riportate di seguito sono particolarmente utili: + **`CPUUtilization`**: mostra la percentuale di utilizzo della CPU. + **`VolumeWriteIOPs`**— Mostra il numero medio di I/O scritture su disco sul volume del cluster, riportate a intervalli di 5 minuti. + **`MainRequestQueuePendingRequests`**: mostra il numero di richieste in attesa di esecuzione nella coda di input. È inoltre possibile scoprire quante richieste sono in sospeso sul server utilizzando l'[endpoint di stato delle query Gremlin](gremlin-api-status.md) con il parametro `includeWaiting`. In questo modo si ottiene lo stato di tutte le query in attesa. I seguenti indicatori possono consentono di modificare le strategie di provisioning e di query di Neptune per migliorare l'efficienza e le prestazioni: + La latenza costante, alta`CPUUtilization`, alta `VolumeWriteIOPs` e bassa `MainRequestQueuePendingRequests` insieme dimostra che il server è attivamente impegnato nell'elaborazione di richieste di scrittura simultanee a un ritmo sostenibile, con tempi di attesa minimi. I/O + Latenza costante, valore `CPUUtilization` basso, valore `VolumeWriteIOPs` basso e valore `MainRequestQueuePendingRequests` pari a zero insieme indicano una capacità eccessiva sull'istanza database primaria per l'elaborazione delle richieste di scrittura. + Valore `CPUUtilization` alto e valore `VolumeWriteIOPs` alto ma latenza variabile e valore `MainRequestQueuePendingRequests` insieme indicano che si sta inviando più lavoro di quanto il server sia in grado di elaborare in un determinato intervallo. Prendi in considerazione la possibilità di creare o ridimensionare le richieste batch in modo da svolgere la stessa quantità di lavoro con un minore sovraccarico transazionale, and/or scalando l'istanza principale verso l'alto per aumentare il numero di thread di query in grado di elaborare contemporaneamente le richieste di scrittura. + Basso `CPUUtilization` con alto `VolumeWriteIOPs` significa che i thread di query sono in attesa del completamento delle operazioni a livello di storage. I/O Se si notano latenze variabili e un certo aumento del valore `MainRequestQueuePendingRequests`, prendere in considerazione la possibilità di creare o ridimensionare le richieste batch in modo da svolgere la stessa quantità di lavoro con un minore sovraccarico transazionale. # Metriche di Neptune CloudWatch **Nota** Amazon Neptune invia i parametri solo quando hanno un CloudWatch valore diverso da zero. Per tutti le metriche Neptune, la granularità dell'aggregazione è di 5 minuti. **Topics** + [Metriche di Neptune CloudWatch](#cw-metrics-available) + [CloudWatch Metriche che ora sono obsolete in Neptune](#cw-metrics-deprecated) ## Metriche di Neptune CloudWatch La tabella seguente elenca le CloudWatch metriche supportate da Neptune. **Nota** Tutti le metriche cumulative vengono azzerate ogni volta che il server viene riavviato, sia per manutenzione, riavvio o ripristino dopo un arresto anomalo. **Metriche di Neptune CloudWatch** | Metrica | Description | | --- | --- | | `BackupRetentionPeriodStorageUsed` | La quantità totale di spazio di archiviazione di backup, espressa in byte, utilizzata per il supporto dalla finestra di conservazione del backup del cluster database Neptune. Incluso nel totale riportato dal parametro `TotalBackupStorageBilled`. | | `BufferCacheHitRatio` | La percentuale di richieste gestite dalla cache del buffer. Questa metrica può essere utile per diagnosticare la latenza delle query, poiché mancati riscontri della cache provocano una latenza significativa. Se il rapporto di riscontri della cache è inferiore al 99,9%, valutare la possibilità di aggiornare il tipo di istanza per memorizzare nella cache più dati in memoria. | | `ClusterReplicaLag` | Per una replica di lettura, il ritardo durante la replica degli aggiornamenti dall'istanza principale, in millisecondi. | | `ClusterReplicaLagMaximum` | Il ritardo massimo tra l'istanza primaria e ogni istanza database Neptune nel cluster database, in millisecondi. | | `ClusterReplicaLagMinimum` | Il ritardo minimo tra l'istanza primaria e ogni istanza database Neptune nel cluster database, in millisecondi. | | `CPUCreditBalance` | Il numero di crediti CPU accumulati da un'istanza, segnalati a intervalli di 5 minuti. Viene utilizzato per determinare per quanto tempo un'istanza database può superare il proprio livello di prestazioni di base a una determinata velocità. | | `CPUCreditUsage` | Il numero di crediti CPU consumati durante il periodo specificato, segnalato a intervalli di 5 minuti. Questa metrica misura la quantità di tempo durante la quale i dati fisici CPUs sono stati utilizzati per l'elaborazione delle istruzioni mediante CPUs allocazioni virtuali all'istanza DB. | | `CPUSurplusCreditBalance` | Il numero di crediti extra spesi da un'istanza illimitata quando il rispettivo valore `CPUCreditBalance` è pari a zero. Il valore `CPUSurplusCreditBalance` viene saldato con i crediti CPU ottenuti. Se il numero dei crediti extra va oltre il numero massimo di crediti che un'istanza può ottenere in un periodo di 24 ore, i crediti extra spesi, eccedenti il limite, incorreranno in costi aggiuntivi. I parametri di credito CPU sono disponibili solo con una frequenza di 5 minuti. | | `CPUSurplusCreditsCharged` | Il numero di crediti in eccesso spesi che non vengono rimborsati dai crediti CPU guadagnati e che comportano un costo aggiuntivo. | | `CPUUtilization` | La percentuale di utilizzo della CPU. | | `EngineUptime` | Il periodo di esecuzione dell'istanza, in secondi. | | `FreeableMemory` | La quantità di memoria RAM disponibile, in byte. | | `GlobalDbDataTransferBytes` | Il numero di byte di dati di redo log trasferiti dal primario Regione AWS a uno secondario Regione AWS in un database globale di Neptune. | | `GlobalDbReplicatedWriteIO` | Il numero di I/O operazioni di scrittura replicate dal primario Regione AWS nel database globale al volume del cluster in un database secondario. Regione AWS I calcoli di fatturazione per ogni cluster database in un database globale Neptune utilizzano la metrica `VolumeWriteIOPS` per determinare il numero di scritture eseguite all'interno del cluster. Per il cluster database primario, i calcoli di fatturazione usano `GlobalDbReplicatedWriteIO` per tenere conto della replica tra regioni nei cluster database secondari. | | `GlobalDbProgressLag` | Numero di millisecondi di ritardo del cluster secondario rispetto al cluster primario sia per le transazioni utente che per le transazioni di sistema. | | `GremlinClientErrorsPerSec` | Numero di errori lato client al secondo negli attraversamenti Gremlin. | | `GremlinServerErrorsPerSec` | Numero di errori lato server al secondo negli attraversamenti Gremlin. | | `GremlinRequestsPerSec` | Numero di richieste al secondo al motore Gremlin. | | `GremlinWebSocketOpenConnections` | Il numero di WebSocket connessioni aperte con Neptune. | | `LoaderClientErrorsPerSec` | Numero di errori lato client al secondo da richieste del Loader. | | `LoaderRequestsPerSec` | Numero di richieste dello strumento di caricamento al secondo. | | `LoaderServerErrorsPerSec` | Numero di errori lato server del Loader al secondo. | | `MainRequestQueuePendingRequests` | Numero di richieste in attesa di esecuzione nella coda di input. Neptune inizia a limitare le richieste quando superano la capacità massima della coda. | | `NCUUtilization``` | Applicabile solo a un'istanza database o un cluster DB [Neptune Serverless](neptune-serverless.md). A livello di istanza, riporta una percentuale calcolata come il numero di unità di capacità Neptune NCUs () attualmente utilizzate dall'istanza in questione, diviso per l'impostazione della capacità NCU massima per il cluster. Un'unità di capacità Neptune (NCU, Neptune Capacity Unit) è costituita da 2 GiB (gibibyte) di memoria (RAM) insieme alle reti e alla capacità del processore virtuale (vCPU) associate. A livello di cluster, `NCUUtilization` riporta la percentuale di capacità massima utilizzata dal cluster nel suo complesso. | | `NetworkThroughput` | La velocità di trasmissione effettiva della rete in byte al secondo in entrata e in uscita dei client per ogni istanza del cluster database Neptune. Questa velocità di trasmissione effettiva **non** include il traffico di rete tra le istanze del cluster database e il volume del cluster. | | `NetworkTransmitThroughput` | La velocità di trasmissione effettiva della rete in byte al secondo in uscita dei client per ogni istanza del cluster database Neptune. Questa velocità di trasmissione effettiva **non** include il traffico di rete tra le istanze del cluster database e il volume del cluster. | | NumIndexDeletesPerSec | Numero di eliminazioni da singoli indici. Le eliminazioni da ciascun indice vengono conteggiate singolarmente. Ciò include le eliminazioni che possono essere annullate se una query rileva un errore. | | NumIndexInsertsPerSec | Numero di inserimenti nei singoli indici. Gli inserti in ciascun indice vengono contati separatamente. Ciò include gli inserti che possono essere ripristinati se una query rileva un errore. | | NumIndexReadsPerSec | Numero di dichiarazioni scansionate da qualsiasi indice. Qualsiasi modello di accesso inizia con una ricerca su un indice e legge tutte le istruzioni corrispondenti. Un aumento di questa metrica può causare un aumento delle latenze di query o dell'utilizzo della CPU. | | `NumOpenCypherClientErrorsPerSec` | Il numero di errori del OpenCypher client al secondo. | | `NumOpenCypherRequestsPerSec` | Il numero di OpenCypher richieste al secondo. | | `NumOpenCypherServerErrorsPerSec` | Il numero di errori del OpenCypher server al secondo. | | `NumQueuedRequestsPerSec` | Il numero di richieste in coda al secondo. | | `NumResultCacheHit` | Numero di accessi alla cache dei risultati di Gremlin. | | `NumResultCacheMiss` | Numero di errori nella cache dei risultati di Gremlin. | | `NumTxCommitted` | Il numero di transazioni impegnate correttamente al secondo. | | `NumTxOpened` | Il numero di transazioni aperte sul server al secondo. | | `NumTxRolledBack` | Per le query di scrittura, il numero di transazioni al secondo di cui è stato eseguito il rollback sul server a causa di errori. Per le query di sola lettura, questa metrica è uguale al numero di transazioni di sola lettura completate al secondo. | | NumUndoPagesPurged | Questa metrica indica il numero di batch eliminati. Questa metrica indica lo stato di avanzamento della rimozione. Il valore è 0 per le istanze Reader e la metrica si applica solo all'istanza Writer. | | `OpenCypherRequestsPerSec` | Numero di richieste al secondo (sia HTTPS che Bolt) al motore openCypher. | | `OpenCypherBoltOpenConnections` | Il numero di connessioni Bolt aperte a Neptune. | | `ResultCacheSizeInBytes` | Dimensione totale stimata (in byte) di tutti gli elementi memorizzati nella cache dei risultati di Gremlin. | | `ResultCacheItemCount` | Numero di elementi nella cache dei risultati di Gremlin. | | `ResultCacheOldestItemTimestamp` | Il timestamp dell'elemento più vecchio memorizzato nella cache dei risultati di Gremlin. | | `ResultCacheNewestItemTimestamp` | Il timestamp dell'elemento più recente memorizzato nella cache dei risultati di Gremlin. | | `ServerlessDatabaseCapacity` | [Come metrica a livello di istanza, `ServerlessDatabaseCapacity` riporta la capacità corrente dell'istanza di una determinata istanza serverless di Neptune, in.](neptune-serverless.md) NCUs Un'unità di capacità Neptune (NCU, Neptune Capacity Unit) è costituita da 2 GiB (gibibyte) di memoria (RAM) insieme alle reti e alla capacità del processore virtuale (vCPU) associate. A livello di cluster, `ServerlessDatabaseCapacity` riporta la media di tutti i valori `ServerlessDatabaseCapacity` delle istanze database del cluster. | | `SnapshotStorageUsed` | La quantità totale di spazio di archiviazione di backup, espressa in byte, utilizzata da tutti gli snapshot per un cluster database Neptune al di fuori della finestra di conservazione dei backup. Incluso nel totale riportato dal parametro `TotalBackupStorageBilled`. | | `SparqlClientErrorsPerSec` | Il numero di errori lato client al secondo in query SPARQL. | | `SparqlRequestsPerSec` | Il numero di richieste al secondo al motore SPARQL. | | `SparqlServerErrorsPerSec` | Il numero di errori del server SPARQL al secondo. | | `StatsNumStatementsScanned` | Numero totale di istruzioni analizzate per le [statistiche DFE](neptune-dfe-statistics.md) dall'avvio del server. Ogni volta che viene attivato il calcolo delle statistiche, questo numero aumenta ma quando non viene eseguito alcun calcolo, rimane statico. Di conseguenza, se lo si rappresenta graficamente nel tempo, è possibile capire quando il calcolo è avvenuto e quando non è avvenuto: ![\[Grafico dei valori StatsNumStatementsScanned nel tempo\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/images/StatsNumStatementsScanned-graph.png) Osservando la pendenza del grafico nei periodi in cui la metrica è in aumento, si può anche capire la velocità di calcolo. Se non esiste una metrica di questo tipo, significa che la funzionalità delle statistiche è disabilitata nel cluster database o che la versione del motore in uso non la include. Se il valore della metrica è zero, significa che non è stato effettuato alcun calcolo delle statistiche. | | `StorageNetworkReceiveThroughput` | La quantità di throughput di rete ricevuta dal sottosistema di archiviazione da ogni istanza del cluster Neptune DB. | | StorageNetworkThroughput | La quantità di throughput di rete ricevuta e inviata al sottosistema di archiviazione da ciascuna istanza del cluster Neptune DB. | | `StorageNetworkTransmitThroughput` | La quantità di throughput di rete inviata al sottosistema di archiviazione da ogni istanza del cluster Neptune DB. | | `SwapUsage` | La quantità di spazio di scambio utilizzato. | | `TempStorageIOPS` | Il numero di IOPS per la lettura e la scrittura sullo storage locale collegato all'istanza DB Neptune. Questo parametro rappresenta un conteggio e viene misurato una volta al secondo. | | `TempStorageThroughput` | La quantità di dati trasferiti da e verso l'archiviazione locale associata all'istanza DB Neptune. Questo parametro rappresenta i byte e viene misurato una volta al secondo. | | `TotalBackupStorageBilled` | La quantità totale di spazio di archiviazione di backup fatturata per un determinato cluster database Neptune, in byte. Include lo storage di backup misurato dai parametri `BackupRetentionPeriodStorageUsed` e `SnapshotStorageUsed`. | | `TotalRequestsPerSec` | Il numero totale di richieste al secondo al server da tutte le origini. | | `TotalClientErrorsPerSec` | Il numero totale al secondo di richieste che hanno causato errori a causa di problemi lato client. | | `TotalServerErrorsPerSec` | Il numero totale al secondo di richieste che hanno causato errori nel server a causa di errori interni. | | `UndoLogListSize` | Il numero di log di annullamento nell'elenco dei log di annullamento. I log di annullamento contengono i record delle transazioni sottoposte a commit che scadono quando tutte le transazioni attive sono più recenti dell'ora del commit. I record scaduti vengono eliminati periodicamente. L'eliminazione dei record per le operazioni di eliminazione può richiedere più tempo rispetto ai record per altri tipi di transazione. L'eliminazione viene eseguita esclusivamente dall'istanza di scrittura del cluster database, quindi la velocità di eliminazione dipende dal tipo di istanza di scrittura. Se il valore `UndoLogListSize` è elevato e in crescita nel cluster database, aggiornare l'istanza di scrittura per aumentare la velocità di eliminazione. Inoltre, se state effettuando l'aggiornamento a una versione Engine `1.2.0.0` o superiore da una versione precedente`1.2.0.0`, assicuratevi innanzitutto che il `UndoLogListSize` valore sia inferiore a una determinata soglia. In caso contrario, la patch verrà ripristinata e avrà esito negativo. Le soglie si basano sul tipo di istanza: il limite predefinito è 40.000 per le istanze 4xlarge o più grandi e 10.000 per le istanze più piccole di 4xlarge. Se si tenta di aggiornare un cluster con una `UndoLogListSize` metrica superiore al limite, il processo di patch verrà annullato, l'aggiornamento verrà annullato e un evento con il motivo sarà visibile nella pagina degli eventi del cluster. Questi limiti possono cambiare per ragioni operative senza preavviso. Poiché le versioni del motore `1.2.0.0` e quelle successive utilizzano un formato diverso per i log di annullamento, l'aggiornamento può iniziare solo dopo che i registri di annullamento precedenti sono stati completamente eliminati al di sotto della soglia applicabile. Per ulteriori informazioni, consulta [Aggiornamento alla versione 1.2.0.0 o successiva](engine-updates-1200-changes.md). | | `VolumeBytesUsed` | La quantità totale di archiviazione allocata al cluster database Neptune, espressa in byte. Questa è la quantità di spazio di archiviazione che ti viene fatturata. È la quantità massima di archiviazione allocata al cluster DB in qualsiasi momento della sua esistenza, non la quantità che si sta attualmente utilizzando (consulta [Fatturazione dell'archiviazione Neptune](feature-overview-storage.md#feature-overview-storage-billing)). | | `VolumeReadIOPs` | Il numero totale di I/O operazioni di lettura fatturate da un volume del cluster, riportato a intervalli di 5 minuti. Le operazioni di lettura fatturate sono calcolate a livello del volume del cluster, aggregate da tutte le istanze nel cluster database Neptune e, in seguito, indicate a intervalli di 5 minuti. | | VolumeWriteIOPs | Il numero totale di I/O operazioni su disco di scrittura sul volume del cluster, riportate a intervalli di 5 minuti. | ## CloudWatch Metriche che ora sono obsolete in Neptune L'uso di queste metriche Neptune è ora obsoleto. Sono ancora supportati, ma potrebbero essere eliminati in futuro man mano che nuove e migliori metriche diventano disponibili. | Metrica | Description | | --- | --- | | `GremlinHttp1xx` | Numero di risposte HTTP 1xx per l'endpoint Gremlin al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http1xx`. | | `GremlinHttp2xx` | Numero di risposte HTTP 2xx per l'endpoint Gremlin al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http2xx`. | | `GremlinHttp4xx` | Numero di errori HTTP 4xx per l'endpoint Gremlin al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http4xx`. | | `GremlinHttp5xx` | Numero di errori HTTP 5xx per l'endpoint Gremlin al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http5xx`. | | `GremlinErrors` | Numero di errori negli attraversamenti Gremlin. | | `GremlinRequests` | Numero di richieste al motore Gremlin. | | `GremlinWebSocketSuccess` | Numero di WebSocket connessioni riuscite all'endpoint Gremlin al secondo. | | `GremlinWebSocketClientErrors` | Numero di errori del WebSocket client sull'endpoint Gremlin al secondo. | | `GremlinWebSocketServerErrors` | Numero di errori del WebSocket server sull'endpoint Gremlin al secondo. | | `GremlinWebSocketAvailableConnections` | Numero di potenziali WebSocket connessioni attualmente disponibili. | | `Http100` | Numero di risposte HTTP 100 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http1xx`. | | `Http101` | Numero di risposte HTTP 101 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http1xx`. | | `Http1xx` | Numero di risposte HTTP 1xx per l'endpoint al secondo. | | `Http200` | Numero di risposte HTTP 200 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http2xx`. | | `Http2xx` | Numero di risposte HTTP 2xx per l'endpoint al secondo. | | `Http400` | Numero di errori HTTP 400 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http4xx`. | | `Http403` | Numero di errori HTTP 403 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http4xx`. | | `Http405` | Numero di errori HTTP 405 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http4xx`. | | `Http413` | Numero di errori HTTP 413 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http4xx`. | | `Http429` | Numero di errori HTTP 429 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http4xx`. | | `Http4xx` | Numero di errori HTTP 4xx per l'endpoint al secondo. | | `Http500` | Numero di errori HTTP 500 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http5xx`. | | `Http501` | Numero di errori HTTP 501 per l'endpoint al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http5xx`. | | `Http5xx` | Numero di errori HTTP 5xx per l'endpoint al secondo. | | `LoaderErrors` | Numero di errori delle richieste dello strumento di caricamento. | | `LoaderRequests` | Numero di richieste dello strumento di caricamento. | | `SparqlHttp1xx` | Numero di risposte HTTP 1xx per l'endpoint SPARQL al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http1xx`. | | `SparqlHttp2xx` | Numero di risposte HTTP 2xx per l'endpoint SPARQL al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http2xx`. | | `SparqlHttp4xx` | Numero di errori HTTP 4xx per l'endpoint SPARQL al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http4xx`. | | `SparqlHttp5xx` | Numero di errori HTTP 5xx per l'endpoint SPARQL al secondo. Al suo posto, ti consigliamo di utilizzare il nuovo parametro combinato `Http5xx`. | | `SparqlErrors` | Numero di errori nelle query SPARQL. | | `SparqlRequests` | Numero di richieste al motore SPARQL. | | `StatusErrors` | Numero di errori dell'endpoint dello stato. | | `StatusRequests` | Numero di richieste all'endpoint dello stato. | # Dimensioni di Nettuno CloudWatch Le metriche di Amazon Neptune vengono qualificate mediante i valori dell'account, il nome del grafo o l'operazione. Puoi utilizzare la CloudWatch console Amazon per recuperare i dati di Neptune insieme a qualsiasi dimensione nella tabella seguente. | Dimensione | Description | | --- | --- | | DBInstanceIdentifier | Filtra i dati richiesti solo per un'istanza database specifica di un cluster. | | DBClusterIdentifier | Filtra i dati richiesti per un cluster database Neptune specifico. | | DBClusterIdentifier, EngineName | Filtra i dati in base al cluster. Il nome del motore per tutte le istanze Neptune è neptune. | | DBClusterIdentifier, Role | Filtra i dati richiesti per un cluster database Neptune specifico, aggregando la metrica in base al ruolo dell'istanza (LETTURA/SCRITTURA). Ad esempio, puoi aggregare i parametri per tutte le istanze READER che appartengono a un cluster. | | DBClusterIdentifier, SourceRegion | Filtra i dati in base al cluster primario in una regione primaria del database globale. | | DatabaseClass | Filtra i dati richiesti per tutte le istanze in una classe di database. Ad esempio, puoi aggregare i parametri per tutte le istanze che appartengono alla classe di database db.r4.large | | EngineName | Il nome del motore per tutte le istanze Neptune è neptune. | | GlobalDbDBClusterIdentifier, SecondaryRegion | Filtra i dati in base al cluster secondario di un database globale specificato in una regione secondaria. | # Utilizzo dei log di audit con i cluster Amazon Neptune Per effettuare l'audit dell'attività del cluster database Amazon Neptune, abilitare la raccolta dei log di audit impostando un parametro del cluster database. Una volta abilitati, i registri di controllo possono essere utilizzati per registrare una qualsiasi combinazione di eventi supportati. Puoi visualizzare o scaricare i log di audit per esaminarli. ## Abilitazione dei log di audit Neptune Utilizza il parametro `neptune_enable_audit_log` per abilitare (`1`) o disabilitare (`0`) i registri di controllo. Imposta questo parametro nel gruppo di parametri che viene utilizzato dal cluster database. Puoi utilizzare la procedura mostrata in [Modifica di un gruppo di parametri del cluster di database o di un gruppo di parametri di database](parameter-groups.md#parameters-editgroup) per modificare il parametro utilizzando o utilizzare il Console di gestione AWS comando [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/neptune/modify-db-cluster-parameter-group.html) o il AWS CLI comando [Modify DBCluster ParameterGroup API per modificare](API_ModifyDBClusterParameterGroup.html) il parametro a livello di codice. Dopo aver modificato questo parametro, è necessario riavviare il cluster database per applicare la modifica. ## Visualizzazione dei log di audit Neptune mediante la console Puoi visualizzare e scaricare i registri di controllo utilizzando la Console di gestione AWS. Nella pagina **Instances (Istanze)**, scegli l'istanza database per visualizzarne i dettagli, successivamente scorri verso la sezione **Logs (Registri)**. Per scaricare un file di log, seleziona il file nella sezione **Logs (Registri)** e successivamente **Download (Scarica)**. ## Dettagli del log di audit Neptune I file di log sono in formato UTF-8. I registri vengono scritti in più file, il cui numero varia a seconda della dimensione dell'istanza. Per visualizzare gli ultimi eventi, potrebbe essere necessario esaminare tutti i file dei registri di controllo. Le voci dei log non sono in ordine sequenziale. Per ordinarle, puoi utilizzare il valore `timestamp`. I file di log sono ruotati quando raggiungono la dimensione di 100 MB in forma aggregata. Questo limite non è configurabile. I file dei log di audit includono le seguenti informazioni delimitate da virgola, in righe, nell'ordine seguente: | Campo | Descrizione | | --- | --- | | Time stamp | Il timestamp Unix per l'evento registrato con una precisione al microsecondo. | | ClientHost | Il nome host o l'IP da cui si connette l'utente. | | ServerHost | Il nome host o l'IP dell'istanza per cui viene registrato l'evento. | | ConnectionType | Il tipo di connessione. Può essere Websocket, HTTP\$1POST, HTTP\$1GET o Bolt. | | ARN IAM del chiamante | L'ARN dell'utente IAM o del ruolo IAM utilizzato per firmare la richiesta. Vuoto se l'autenticazione IAM è disabilitata. Il formato è: `arn:partition:service:region:account:resource` Esempio: `arn:aws:iam::123456789012:user/Anna` `arn:aws:sts::123456789012:assumed-role/AWSNeptuneNotebookRole/SageMaker` | | Auth Context | Contiene un oggetto JSON serializzato contenente informazioni di autenticazione. Il campo `authenticationSucceeded` è `True` se l'utente è stato autenticato. Vuoto se l'autenticazione IAM è disabilitata. | | HttpHeader | Le informazioni di intestazione HTTP. Può contenere una query. Connessioni vuote per WebSocket e Bolt. | | Carico utile | La query Gremlin, SPARQL o openCypher. | # Pubblicazione dei log di Neptune su Amazon Logs CloudWatch Puoi configurare un cluster Neptune DB per pubblicare i dati dei log di audit ( and/or dati di log con query lente) su un gruppo di log in Amazon Logs. CloudWatch Con CloudWatch Logs, puoi eseguire analisi in tempo reale dei dati di log e utilizzarli CloudWatch per creare allarmi e visualizzare i parametri. È possibile utilizzare CloudWatch Logs per archiviare i record di registro in un archivio altamente durevole. Per pubblicare i log di controllo su CloudWatch Logs, i log di controllo devono essere abilitati in modo esplicito (vedi). [Abilitazione dei registri di controllo](auditing.md#auditing-enable) Analogamente, per pubblicare i log con query lente su Logs, i log con query lente devono essere CloudWatch abilitati in modo esplicito (vedi). [Utilizzo della registrazione di log delle query lente di Amazon Neptune](slow-query-logs.md) **Nota** Ricorda quanto segue: Si applicano costi aggiuntivi quando si pubblicano i log su. CloudWatch Consulta la [pagina CloudWatch dei prezzi](https://aws.amazon.com/cloudwatch/pricing/) per i dettagli. Non puoi pubblicare i log nei CloudWatch registri per la regione Cina (Pechino) o Cina (Ningxia). Se l'esportazione dei dati del log è disabilitata, Neptune non elimina i gruppi di log o i flussi di log esistenti. Se l'esportazione dei dati di registro è disabilitata, i dati di registro esistenti rimangono disponibili nei CloudWatch registri, a seconda della conservazione dei log, e all'utente vengono comunque addebitati costi per i dati dei log di controllo archiviati. È possibile eliminare i flussi di log e i gruppi di log utilizzando la console CloudWatch Logs, o l' AWS CLI API Logs. CloudWatch ## Utilizzo della console per pubblicare i log di Neptune nei registri CloudWatch **Per pubblicare i log di Neptune su Logs CloudWatch dalla console** 1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home) 1. Nel pannello di navigazione, seleziona **Database**. 1. Scegliere il cluster database Neptune per cui pubblicare i dati dei log. 1. Per **Operazioni**, scegli **Modifica**. 1. Nella sezione **Esportazioni dei log**, scegli i log che desideri iniziare a pubblicare su Logs. CloudWatch 1. Scegliere **Continue (Continua)** e quindi selezionare **Modify DB Cluster (Modifica cluster DB)** nella pagina di riepilogo. ## Utilizzo della CLI per pubblicare i log di controllo di Neptune su Logs CloudWatch È possibile creare un nuovo cluster DB che pubblica i log di controllo in CloudWatch Logs utilizzando il AWS CLI `create-db-cluster` comando con i seguenti parametri: ``` aws neptune create-db-cluster \ --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --engine neptune \ --enable-cloudwatch-logs-exports '["audit"]' ``` È possibile configurare un cluster DB esistente per pubblicare i log di controllo nei CloudWatch registri utilizzando il AWS CLI `modify-db-cluster` comando con i seguenti parametri: ``` aws neptune modify-db-cluster \ --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit"]}' ``` ## Utilizzo della CLI per pubblicare i log di Neptune con query lente su Logs CloudWatch È inoltre possibile creare un nuovo cluster DB che pubblica i log con query lente su Logs utilizzando il comando con i CloudWatch seguenti parametri: AWS CLI `create-db-cluster` ``` aws neptune create-db-cluster \ --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --engine neptune \ --enable-cloudwatch-logs-exports '["slowquery"]' ``` Allo stesso modo, è possibile configurare un cluster DB esistente per pubblicare log con query lente su Logs utilizzando il comando con i seguenti CloudWatch parametri: AWS CLI `modify-db-cluster` ``` aws neptune modify-db-cluster --region us-east-1 \ --db-cluster-identifier my_db_cluster_id \ --cloudwatch-logs-export-configuration '{"EnableLogTypes":["slowquery"]}' ``` ## Monitoraggio degli eventi di Neptune Log in Amazon CloudWatch Dopo aver abilitato i log di Neptune, puoi monitorare gli eventi di registro in Amazon Logs. CloudWatch Un nuovo gruppo di log viene creato automaticamente per il cluster database Neptune nel seguente prefisso, in cui `cluster-name` rappresenta il nome del cluster database e `log_type` rappresenta il tipo di log: ``` /aws/neptune/cluster-name/log_type ``` Ad esempio, se configuri la funzione di esportazione per includere il log di audit per un cluster di database denominato `mydbcluster`, i dati di log vengono archiviati nel gruppo di log `/aws/neptune/mydbcluster/audit`. Tutti gli eventi di tutte le istanze database in un cluster DB vengono inviati a un gruppo di log utilizzando flussi di log diversi. Se esiste un gruppo di log con il nome specificato, Neptune utilizza quel gruppo di log per esportare i dati di log per il cluster database Neptune. Puoi utilizzare la configurazione automatizzata, ad esempio per creare gruppi di log con periodi di conservazione dei log predefiniti, filtri metrici e accesso dei clienti. AWS CloudFormation In caso contrario, viene creato automaticamente un nuovo gruppo di log utilizzando il periodo di conservazione dei log predefinito, **Never Expire**, in Logs. CloudWatch È possibile utilizzare la console CloudWatch Logs, l'API Logs o l' AWS CLI API CloudWatch Logs per modificare il periodo di conservazione dei log. Per ulteriori informazioni sulla modifica dei periodi di conservazione dei log in CloudWatch Logs, consulta [Change Log Data Retention](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html) in Logs. CloudWatch È possibile utilizzare la console CloudWatch Logs AWS CLI, l'API Logs o l'API CloudWatch Logs per cercare informazioni all'interno degli eventi di registro per un cluster DB. Per ulteriori informazioni sulla ricerca e l'applicazione di filtri per i dati di log, consulta [Ricerca e filtraggio dei dati di log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringLogData.html). # Abilitazione di Amazon CloudWatch Logs per un notebook Neptune CloudWatch I registri per i notebook Neptune sono disabilitati per impostazione predefinita. Seguire questi passaggi per abilitarlo, per il debug o per altri scopi: **Utilizzo di Console di gestione AWS per abilitare CloudWatch i log per un notebook Neptune** 1. Apri la console Amazon SageMaker AI all'indirizzo [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/). 1. Nel riquadro di navigazione a sinistra scegli **Notebook**, quindi **Istanze notebook**. Cerca il nome del notebook Neptune per il quale desideri abilitare i log. 1. Vai alla pagina dei dettagli scegliendo il nome dell'istanza notebook menzionata nel passaggio precedente. 1. Se l'istanza notebook è in esecuzione, seleziona il pulsante **Arresta** in alto a destra nella pagina dei dettagli del notebook. 1. In **Autorizzazioni e crittografia** è disponibile un campo per **ARN del ruolo IAM**. Seleziona il collegamento in questo campo per passare al ruolo IAM per questo notebook. 1. Crea la policy seguente: ------ #### [ 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. Salva questa nuova policy e collegala al ruolo IAM nel passaggio 4. 1. Seleziona **Start** in alto a destra nella pagina dei dettagli dell'istanza SageMaker AI Notebook. 1. Quando inizia il flusso dei log, visualizzerai un collegamento **Visualizza log** sotto il campo denominato **Configurazione del ciclo di vita** nella parte inferiore sinistra della sezione **Impostazioni dell'istanza notebook** della pagina dei dettagli. Se il notebook non si avvia, nella pagina dei dettagli del notebook sulla console SageMaker AI verrà visualizzato un messaggio che indica che l'istanza del notebook ha impiegato più di 5 minuti per avviarsi. I CloudWatch log relativi a questo problema sono disponibili sotto il nome:. `(your-notebook-name)/LifecycleConfigOnStart` Se necessario, consulta [Log Amazon SageMaker Events with Amazon CloudWatch](https://docs.aws.amazon.com/sagemaker/latest/dg/logging-cloudwatch.html) per maggiori dettagli. # Utilizzo della registrazione di log delle query lente di Amazon Neptune Identificare, eseguire il debug e ottimizzare una query a esecuzione lenta può essere difficile. Quando è abilitata la registrazione dei log delle query lente di Neptune, gli attributi di tutte le query a esecuzione prolungata vengono registrati automaticamente per semplificare questo processo. **Nota** La registrazione di log delle query lente è stata introdotta nel [rilascio 1.2.1.0 del motore](engine-releases-1.2.1.0.md) Neptune. È possibile abilitare la registrazione di log delle query lente utilizzando il parametro del cluster database [neptune\$1enable\$1slow\$1query\$1log](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log). Questo parametro è impostato su `disabled` per impostazione predefinita. L'impostazione su `info` o `debug` abilita la registrazione di log delle query lente. L'impostazione `info` registra alcuni attributi utili di ogni query a esecuzione lenta, mentre l'impostazione `debug` registra tutti gli attributi disponibili. Per impostare la soglia per quella che è considerata una query a esecuzione lenta, utilizzare il parametro del cluster database [neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold) per specificare il numero di millisecondi dopo i quali una query in esecuzione viene considerata lenta e viene registrata quando è abilitata la registrazione di log delle query lente. Il valore predefinito è 5000 millisecondi (5 secondi). Puoi impostare questi parametri del cluster DB [nella o utilizzando il Console di gestione AWS](parameter-groups.md#parameters-editgroup) AWS CLI comando [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/neptune/modify-db-cluster-parameter-group.html) o la funzione di DBCluster ParameterGroup gestione [Modify](api-parameters.md#ModifyDBClusterParameterGroup). **Nota** I parametri di registrazione di log delle query lente sono dinamici, il che significa che la modifica dei loro valori non richiede né causa il riavvio del cluster database. ## Per visualizzare i log delle query lente in Console di gestione AWS È possibile visualizzare e scaricare i log delle query lente in, come segue: Console di gestione AWS Nella pagina **Istanze**, scegli l'istanza database, quindi scorri la pagina fino alla sezione **Log**. È quindi possibile selezionare un file di log e quindi scegliere **Scarica** per scaricarlo. ## File generati dalla registrazione di log delle query lente in Neptune I file di log generati dalla registrazione di log delle query lente in Neptune hanno le seguenti caratteristiche: + I file sono codificati come UTF-8. + Le query e i relativi attributi vengono registrati in formato JSON. + Gli attributi nulli e vuoti non vengono registrati, ad eccezione dei dati `queryTime`. + I log si estendono su più file, il cui numero varia a seconda della dimensione dell'istanza. + Le voci dei log non sono in ordine sequenziale. Per ordinarle, puoi utilizzare il valore `timestamp`. + Per visualizzare gli ultimi eventi, potrebbe essere necessario esaminare tutti i file di log delle query lente. + I file di log vengono ruotati quando raggiungono la dimensione di 100 MiB in forma aggregata. Questo limite non è configurabile. ## Attributi di query registrati in modalità `info` I seguenti attributi vengono registrati per le query lente quando il parametro del cluster database `neptune_enable_slow_query_log` è stato impostato su `info`: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/slow-query-logs.html) ## Attributi di query registrati in modalità `debug` Quando il parametro del cluster database `neptune_enable_slow_query_log` è impostato su `debug`, vengono registrati i seguenti attributi del contatore di archiviazione oltre agli attributi registrati in modalità `info`: | Attributo | Description | | --- | --- | | `statementsScannedInAllIndexes` | Istruzioni analizzate in tutti gli indici. | | `statementsScannedSPOGIndex` | Istruzioni analizzate nell'indice SPOG. | | `statementsScannedPOGSIndex` | Istruzioni analizzate nell'indice POGS. | | `statementsScannedGPSOIndex` | Istruzioni analizzate nell'indice GPSO. | | `statementsScannedOSGPIndex` | Istruzioni analizzate nell'indice OSGP. | | `statementsScannedInChunk` | Istruzioni analizzate insieme in blocchi. | | `postFilteredStatementScans` | Istruzioni rimaste dopo il post-filtraggio dopo le analisi. | | `distinctStatementScans` | Istruzioni distinte analizzate. | | `statementsReadInAllIndexes` | Istruzioni lette dopo l'analisi post-filtraggio in tutti gli indici. | | `statementsReadSPOGIndex` | Istruzioni lette dopo l'analisi post-filtraggio nell'indice SPOG. | | `statementsReadPOGSIndex` | Istruzioni lette dopo l'analisi post-filtraggio nell'indice POGS. | | `statementsReadGPSOIndex` | Istruzioni lette dopo l'analisi post-filtraggio nell'indice GPSO. | | `statementsReadOSGPIndex` | Istruzioni lette dopo l'analisi post-filtraggio nell'indice OSGP. | | `accessPathSearches` | Numero di ricerche del percorso di accesso. | | `fullyBoundedAccessPathSearches` | Numero di ricerche del percorso di accesso con chiavi completamente limitate. | | `accessPathSearchedByPrefix` | Numero di ricerche del percorso di accesso per prefisso. | | `searchesWhereRecordsWereFound` | Numero di ricerche con 1 o più record come output. | | `searchesWhereRecordsWereNotFound` | Numero di ricerche senza record come output. | | `totalRecordsFoundInSearches` | Record totali trovati da tutte le ricerche. | | `statementsInsertedInAllIndexes` | Numero di istruzioni inserite in tutti gli indici. | | `statementsUpdatedInAllIndexes` | Numero di istruzioni aggiornate in tutti gli indici. | | `statementsDeletedInAllIndexes` | Numero di istruzioni eliminate in tutti gli indici. | | `predicateCount` | Numero di predicati. | | `dictionaryReadsFromValueToIdTable` | Numero di letture del dizionario dal valore della tabella ID. | | `dictionaryReadsFromIdToValueTable` | Numero di letture del dizionario dall'ID della tabella valori. | | `dictionaryWritesToValueToIdTable` | Numero di scritture del dizionario nel valore della tabella ID. | | `dictionaryWritesToIdToValueTable` | Numero di scritture del dizionario nell'ID della tabella valori. | | `rangeCountsInAllIndexes` | Numero di conteggio intervalli in tutti gli indici. | | `deadlockCount` | Numero di deadlock nella query. | | `singleCardinalityInserts` | Numero di inserimenti a cardinalità singola eseguiti. | | `singleCardinalityInsertDeletions` | Numero di istruzioni eliminate durante un inserimento a cardinalità singola. | | `sharedLocksWaitTimeMillis` | Numero di millisecondi trascorsi in attesa di blocchi condivisi. | | `exclusiveLocksWaitTimeMillis` | Numero di millisecondi trascorsi in attesa di blocchi esclusivi. | ## Esempio di registrazione di log di debug per una query lenta L'esecuzione della seguente query Gremlin potrebbe richiedere più tempo rispetto alla soglia impostata per le query lente: ``` gremlin=g.V().has('code','AUS').repeat(out().simplePath()).until(has('code','AGR')).path().by('code').limit(20).fold() ``` Quindi, se si abilita la registrazione di log delle query lente in modalità debug, verranno registrati i seguenti attributi per la query, in un formato simile a quello riportato di seguito: ``` { "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 } } ``` # Registrazione delle chiamate API Amazon Neptune con AWS CloudTrail Amazon Neptune è integrato AWS CloudTrail con, un servizio che fornisce un registro delle azioni intraprese da un utente, ruolo o AWS servizio in Neptune. CloudTrail acquisisce le chiamate API per Neptune come eventi, incluse le chiamate dalla console Neptune e le chiamate in codice a Neptune. APIs CloudTrail registra solo gli eventi per le chiamate API di gestione di Neptune, come la creazione di un'istanza o di un cluster. Per controllare le modifiche al tuo grafo, puoi utilizzare i log di audit. Per ulteriori informazioni, consulta [Utilizzo dei log di audit con i cluster Amazon Neptune](auditing.md). **Importante** La console AWS CLI di Amazon Neptune e le chiamate API vengono registrate come chiamate effettuate all'API Amazon Relational Database Service (Amazon RDS). Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per Neptune. **Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli eventi.** Utilizzando le informazioni raccolte da CloudTrail, è possibile determinare la richiesta effettuata a Neptune, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e dettagli aggiuntivi. Per ulteriori informazioni CloudTrail, consulta la Guida per l'[AWS CloudTrail utente](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). # Informazioni su Nettuno in CloudTrail CloudTrail è abilitato sul tuo AWS account al momento della creazione dell'account. **Quando si verifica un'attività in Amazon Neptune, tale attività viene registrata in CloudTrail un evento insieme ad AWS altri eventi di servizio nella cronologia degli eventi.** Puoi visualizzare, cercare e scaricare eventi recenti nel tuo AWS account. Per ulteriori informazioni, consulta [Visualizzazione degli eventi con la cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Per una registrazione continua degli eventi nel tuo AWS account, inclusi gli eventi per Neptune, crea un percorso. Un trail consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando si crea un trail nella console, il trail sarà valido in tutte le Regioni . Il trail registra gli eventi di tutte le regioni della AWS partizione e consegna i file di log al bucket Amazon S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei log. CloudTrail Per ulteriori informazioni, consulta: + [Panoramica della creazione di un trail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail Servizi e integrazioni supportati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configurazione delle notifiche Amazon SNS per CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Ricezione di file di CloudTrail registro da più regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [ricezione di file di CloudTrail registro da](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) più account Se viene eseguita un'azione per conto del tuo AWS account utilizzando la console Neptune, l'interfaccia a riga di comando di Neptune o l'SDK Neptune, registra l'azione come chiamate effettuate all'API APIs Amazon RDS. AWS CloudTrail [Ad esempio, se utilizzi la console Neptune per modificare un'istanza DB o richiamare AWS CLI[modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/neptune/modify-db-instance.html)il comando, il log mostra una chiamata AWS CloudTrail all'azione Amazon RDS API Modify. DBInstance](API_ModifyDBInstance.html) [Per un elenco delle azioni dell'API Neptune registrate da AWS CloudTrail, consulta il Neptune API Reference.](neptune-api-reference.html) **Nota** AWS CloudTrail registra solo gli eventi per le chiamate API di gestione di Neptune, come la creazione di un'istanza o di un cluster. Per controllare le modifiche al tuo grafo, puoi utilizzare i log di audit. Per ulteriori informazioni, consulta [Utilizzo dei log di audit con i cluster Amazon Neptune](auditing.md). Ogni evento o voce di registro contiene informazioni sull'utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue: + Se la richiesta è stata effettuata con le credenziali dell'utente IAM o root. + Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato. + Se la richiesta è stata effettuata da un altro servizio. AWS Per ulteriori informazioni, consulta [Elemento CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). # Informazioni sulle voci dei file di registro di Neptune Un trail è una configurazione che consente la distribuzione di eventi come file di log in un bucket Amazon S3 specificato dall'utente. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia ordinata dello stack delle chiamate API pubbliche, quindi non vengono visualizzati in un ordine specifico. L'esempio seguente mostra un CloudTrail registro per un utente che ha creato un'istantanea di un'istanza DB e poi ha eliminato quell'istanza utilizzando la console Neptune. La console è identificata dall'elemento `userAgent`. Le chiamate API richieste effettuate dalla console (`CreateDBSnapshot` e `DeleteDBInstance`) si trovano nell'elemento `eventName` di ciascun record. Le informazioni relative all'utente (`Alice`) sono disponibili nell'elemento `userIdentity`. ``` { 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" } } ] } ``` # Utilizzo della notifica di eventi Neptune **Topics** + [Categorie di eventi Amazon Neptune e messaggi di evento](event-lists.md) + [Sottoscrizione alle notifiche eventi Neptune](events-subscribing.md) + [Gestione delle sottoscrizioni alle notifiche eventi Neptune](events-manage.md) Amazon Neptune usa Amazon Simple Notification Service (Amazon SNS) per fornire le notifiche quando si verifica un evento Neptune. Queste notifiche possono essere in qualsiasi forma supportata da Amazon SNS per una AWS regione, ad esempio un'e-mail, un messaggio di testo o una chiamata a un endpoint HTTP. Neptune raggruppa questi eventi in categorie che puoi sottoscrivere per ricevere una notifica quando si verifica un evento di tale categoria. Puoi sottoscrivere una categoria di eventi per un'istanza database, un cluster database, uno snapshot DB, uno snapshot cluster database o un gruppo di parametri database. Ad esempio, sottoscrivendo la categoria Backup per una determinata istanza database, riceverai una notifica ogni volta che si verifica un evento relativo al backup che interessa l'istanza database. Riceverai una notifica anche quando viene modificata la sottoscrizione a una notifica eventi. Gli eventi si verificano sia a livello di cluster database che di istanza database, quindi puoi ricevere gli eventi se esegui la sottoscrizione a un cluster database o a un'istanza database. Le notifiche eventi vengono inviate all'indirizzo fornito al momento della creazione della sottoscrizione. È possibile creare più sottoscrizioni diverse, ad esempio una che riceve notifiche per tutti gli eventi e un'altra che include solo gli eventi critici per le istanze database di produzione. Puoi disattivare facilmente la notifica senza eliminare una sottoscrizione. A tale scopo, imposta il pulsante di opzione **Abilitato** su **No** nella console Neptune. **Importante** Amazon Neptune non garantisce l'ordine degli eventi inviati in un flusso di eventi. Tale ordine è soggetto a modifiche. Neptune usa il nome della risorsa Amazon (ARN) di un argomento Amazon SNS per identificare ogni sottoscrizione. La console Neptune crea automaticamente l'ARN quando crei la sottoscrizione. La fatturazione per la notifica degli eventi Neptune avviene tramite Amazon SNS. L'uso della notifica degli eventi è soggetta alle tariffe di Amazon SNS. Per ulteriori informazioni, consulta [Prezzi di Amazon Simple Notification Service](https://aws.amazon.com/sns/#pricing). # Categorie di eventi Amazon Neptune e messaggi di evento Neptune genera un numero significativo di eventi in categorie a cui puoi effettuare la sottoscrizione tramite la console Neptune. Ogni categoria si applica a un tipo di origine, ad esempio un'istanza database, uno snapshot DB o un gruppo di parametri database. **Nota** Neptune utilizza le definizioni degli eventi Amazon RDS esistenti e. IDs ## Eventi Neptune provenienti da istanze database La tabella seguente riporta un elenco di eventi per categoria di eventi applicabili quando il tipo di origine è un'istanza database. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/event-lists.html) ## Eventi Neptune provenienti da un cluster database La tabella seguente riporta un elenco di eventi per categoria di eventi applicabili quando il tipo di origine è un cluster database. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/event-lists.html) ## Eventi Neptune provenienti da uno snapshot del cluster database La tabella seguente riporta la categoria di eventi e un elenco di eventi applicabili quando il tipo di origine è uno snapshot del cluster database Neptune. | Categoria | ID evento RDS | Descrizione | | --- | --- | --- | | backup | RDS-EVENT-0074 | È stata avvia la creazione di uno snapshot cluster di database manuale. | | backup | RDS-EVENT-0075 | È stato creato uno snapshot cluster di database manuale. | | notifica | RDS-EVENT-0162 | Attività di esportazione snapshot cluster di database non riuscita. | | notifica | RDS-EVENT-0163 | Attività di esportazione snapshot cluster di database annullata. | | notifica | RDS-EVENT-0164 | Attività di esportazione snapshot cluster di database completata. | | backup | RDS-EVENT-0168 | Creazione snapshot cluster automatizzato. | | backup | RDS-EVENT-0169 | Snapshot di cluster automatizzato creato. | | creazione | RDS-EVENT-0170 | Cluster di database creato. | | eliminazione | RDS-EVENT-0171 | Cluster di database eliminato. | | notifica | RDS-EVENT-0172 | Rinominato cluster di database da [vecchio nome cluster di database] a [nuovo nome cluster di database]. | ## Eventi Neptune provenienti da un gruppo di parametri del cluster database La tabella seguente riporta la categoria di eventi e un elenco di eventi applicabili quando il tipo di origine è un gruppo di parametri del cluster database. | Categoria | ID evento RDS | Descrizione | | --- | --- | --- | | modifica della configurazione | RDS-EVENT-0037 | Il gruppo di parametri è stato modificato. | ## Eventi Neptune provenienti da un gruppo di sicurezza La tabella seguente riporta la categoria di eventi e un elenco di eventi applicabili quando il tipo di origine è un gruppo di sicurezza. | Categoria | ID evento RDS | Descrizione | | --- | --- | --- | | modifica della configurazione | RDS-EVENT-0038 | Il gruppo di sicurezza è stato modificato. | | errore | RDS-EVENT-0039 | Il gruppo di sicurezza appartenente a [utente] non esiste. L'autorizzazione per il gruppo di sicurezza è stata revocata. | # Sottoscrizione alle notifiche eventi Neptune Puoi usare la console Neptune per sottoscrivere le notifiche degli eventi, come segue: **Per sottoscrivere una notifica eventi Neptune** 1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home) 1. Nel pannello di navigazione selezionare **Event subscriptions (Sottoscrizioni di eventi)**. 1. Nel riquadro **Event subscriptions (Sottoscrizioni di eventi)** scegliere **Create event subscription (Crea sottoscrizione di eventi)**. 1. Nella finestra di dialogo **Create event subscription (Crea sottoscrizione di eventi)**, seguire questa procedura: 1. Per **Name (Nome)**, immettere un nome per la sottoscrizione alle notifiche eventi. 1. Per **Send notifications to (Invia notifiche a)**, scegliere un ARN Amazon SNS esistente per un argomento Amazon SNS oppure scegliere **create topic (crea argomento)** per immettere il nome di un argomento e un elenco di destinatari. 1. Per **Source type (Tipo di origine)** scegliere un tipo di origine. 1. Scegliere **Yes (Sì)** per abilitare la sottoscrizione. Per creare una sottoscrizione senza ricevere subito le notifiche, scegliere **No**. 1. A seconda del tipo di origine selezionato, scegliere le categorie di eventi e le origini da cui ricevere le notifiche eventi. 1. Scegli **Create** (Crea). # Gestione delle sottoscrizioni alle notifiche eventi Neptune Se scegli **Sottoscrizioni a eventi** nel riquadro di navigazione della console Neptune, puoi visualizzare le categorie di sottoscrizione e un elenco delle sottoscrizioni correnti. Puoi anche modificare o eliminare una sottoscrizione specifica. ## Modifica delle sottoscrizioni alle notifiche eventi Neptune **Per modificare una sottoscrizione alle notifiche eventi Neptune corrente** 1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home) 1. Nel pannello di navigazione selezionare **Event subscriptions (Sottoscrizioni di eventi)**. Il riquadro **Event subscriptions (Sottoscrizioni di eventi)** mostra tutte le sottoscrizioni delle notifiche degli eventi. 1. Nel riquadro **Event subscriptions (Sottoscrizioni di eventi)** scegliere la sottoscrizione da modificare e selezionare **Edit (Modifica)**. 1. Apportare le modifiche alla sottoscrizione nella sezione **Target (Destinazione)** o **Source (Origine)**. Puoi aggiungere o rimuovere gli identificatori di origine selezionandoli o deselezionandoli nella sezione **Origine**. 1. Scegli **Modifica**. La console Neptune indica che è in corso la modifica della sottoscrizione. ## Eliminazione di una sottoscrizione alle notifiche eventi Neptune Puoi eliminare un abbonamento quando questo non è più necessario. Tutti gli abbonati all'argomento non riceveranno più le notifiche di eventi specificate dall'abbonamento. **Per eliminare una sottoscrizione alle notifiche eventi Neptune** 1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home) 1. Nel pannello di navigazione selezionare **Event subscriptions (Sottoscrizioni di eventi)**. 1. Nel riquadro **Sottoscrizione a eventi** scegliere la sottoscrizione che si vuole eliminare. 1. Scegli **Elimina**. 1. La console Neptune indica che è in corso l'eliminazione della sottoscrizione. # Etichettare le risorse di Amazon Neptune È possibile usare i tag di Neptune per aggiungere metadati alle risorse di Neptune. Inoltre, puoi utilizzare tag con policy AWS Identity and Access Management (IAM) per gestire l'accesso alle risorse di Neptune e controllare quali azioni possono essere applicate a tali risorse. Infine, i tag possono essere utilizzati per monitorare i costi raggruppando le spese per risorse con tag simili. È possibile applicare tag a tutte le risorse amministrative di Neptune, tra cui: + Istanze DB + Cluster database + Repliche di lettura + Snapshot DB + Snapshot cluster database + Abbonamenti a eventi + Gruppi di parametri database + Gruppi di parametri di cluster database + Gruppi di sottoreti database ## Panoramica dei tag delle risorse di Neptune Un tag di Amazon Neptune è una coppia nome-valore definita e associata alla risorsa di Neptune. Il nome viene definito *chiave*. L'indicazione di un valore per la chiave è un'operazione facoltativa. È possibile usare i tag per assegnare informazioni arbitrarie a una risorsa di Neptune. Una chiave tag potrebbe essere impiegata, ad esempio, per definire una categoria e il valore di tag potrebbe essere un elemento di tale categoria. Ad esempio, puoi definire una chiave di tag "progetto" e un valore di tag "Salix", che indica che la risorsa Neptune viene assegnata al progetto Salix. È anche possibile usare i tag per indicare le risorse di Neptune usate a scopo di test o produzione tramite una chiave, ad esempio `environment=test` o `environment=production`. È consigliabile utilizzare un set coerente di chiavi di tag per agevolare il monitoraggio dei metadati associati alle risorse di Neptune. Utilizzate i tag per organizzare la AWS fattura in modo da rispecchiare la vostra struttura dei costi. A tale scopo, registrati per ricevere la Account AWS fattura con i valori chiave dell'etichetta inclusi. Per visualizzare il costo delle risorse combinate, puoi organizzare le informazioni di fatturazione in base alle risorse con gli stessi valori di chiave di tag. Puoi ad esempio applicare tag a numerose risorse con un nome di applicazione specifico, quindi organizzare le informazioni di fatturazione per visualizzare il costo totale dell'applicazione in più servizi. Per ulteriori informazioni, consulta la pagina sull'[utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *Guida per l'utente di AWS Billing *. Ogni risorsa di Neptune dispone di un set di tag contenente tutti i tag assegnati a tale risorsa di Neptune. Un set di tag può contenere fino a 10 tag ma può anche essere vuoto. Se aggiungi un tag a una risorsa di Neptune con la stessa chiave di un tag esistente sulla risorsa, il nuovo valore sovrascrive quello precedente. AWS non applica alcun significato semantico ai tag; i tag vengono interpretati rigorosamente come stringhe di caratteri. Neptune può impostare i tag in un'istanza database o in altre risorse di Neptune, a seconda delle impostazioni scelte al momento della creazione della risorsa. Ad esempio, Neptune potrebbe aggiungere un tag che indica che un'istanza database viene utilizzata solo a scopo di test o produzione. + La chiave di tag corrisponde al nome obbligatorio del tag. Il valore della stringa può essere composto da 1 a 128 caratteri Unicode e non può avere il prefisso "`aws:`" o "`rds:`". La stringa può contenere solo il set di lettere, cifre, spazi vuoti, "\$1", ".", "/", "=", "\$1", "-" Unicode (espressioni regolari Java: "`^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$`"). + Il valore di tag è un valore di stringa opzionale del tag. Il valore della stringa può essere composto da 1 a 256 caratteri Unicode e non può avere il prefisso "`aws:`". La stringa può contenere solo il set di lettere, cifre, spazi vuoti, "\$1", ".", "/", "=", "\$1", "-" Unicode (espressioni regolari Java: "`^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$`"). I valori non devono essere necessariamente univoci in un set di tag e possono essere Null. Ad esempio, puoi avere una coppia chiave-valore in un set di tag `project/Trinity` e `cost-center/Trinity`. **Nota** È possibile aggiungere un tag a una snapshot. Tuttavia, l'addebito non rifletterà questo raggruppamento. È possibile utilizzare l' Console di gestione AWS API Neptune o la Neptune per aggiungere, elencare ed eliminare tag sulle risorse Neptune. AWS CLI Quando utilizzi l'API AWS CLI o l'API Neptune, devi fornire l'Amazon Resource Name (ARN) per la risorsa Neptune con cui desideri lavorare. Per ulteriori informazioni sulla creazione di un ARN, consultare [Costruzione di un ARN per Neptune](tagging-arns-constructing.md). I tag sono memorizzati nella cache a fini di autorizzazione. Questo è il motivo per il quale le aggiunte e gli aggiornamenti dei tag delle risorse di Neptune potrebbero richiedere diversi minuti prima di diventare disponibili. ### Copiare i tag in Neptune Quando si crea o si ripristina un'istanza database, è possibile specificare che i tag dell'istanza database vengano copiati nelle snapshot dell'istanza database. La copia dei tag garantisce che i metadati delle snapshot DB corrispondano a quelli dell'istanza database di origine e che anche le policy di accesso alla snapshot DB corrispondano a quelle dell'istanza database di origine. I tag non vengono copiati per impostazione predefinita. È possibile specificare che i tag vengano copiati nelle snapshot DB per le seguenti azioni: + Creazione di un'istanza database. + Ripristino di un'istanza database. + Creazione di una replica di lettura. + Copia di una snapshot DB. **Nota** Se includi un valore per il `--tag-key` parametro del [create-db-cluster-snapshot](https://docs.aws.amazon.com/cli/latest/reference/neptune/create-db-cluster-snapshot.html) AWS CLI comando (o fornisci almeno un tag all'azione [Crea istantanea DBCluster](api-snapshots.md#CreateDBClusterSnapshot) API), Neptune non copia i tag dall'istanza DB di origine alla nuova istantanea del database. Questo comportamento si applica anche se l'istanza database di origine ha l'opzione `--copy-tags-to-snapshot` (`CopyTagsToSnapshot`) abilitata. In questo caso puoi creare una copia di un'istanza database da una snapshot DB ed evitare l'aggiunta di tag che non si applicano alla nuova istanza database. Dopo aver creato lo snapshot DB utilizzando il AWS CLI `create-db-cluster-snapshot` comando (o l'`CreateDBClusterSnapshot`azione dell'API Neptune), è possibile aggiungere tag come descritto più avanti in questo argomento. # Taggare Neptune usando il Console di gestione AWS Il processo di applicazione dei tag a una risorsa di Amazon Neptune è simile per tutte le risorse. Di seguito viene mostrato come applicare i tag a un'istanza database Neptune. **Aggiunta di un tag a un'istanza database** 1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home) 1. Nel riquadro di navigazione, scegliere **Instances (Istanze)**. **Nota** Per filtrare l'elenco di istanze database nel riquadro **Instances (Istanze)**, digitare una stringa di testo nella casella **Filter instances (Filtra istanze)**. Vengono visualizzate solo le istanze database che contengono la stringa. 1. Scegli l'istanza database a cui applicare i tag. 1. Scegli **Instance actions (Operazioni istanza)** e successivamente **See details (Visualizza dettagli)**. 1. Nella sezione dei dettagli, scorrere verso il basso fino alla sezione **Tags (Tag)**. 1. Scegliere **Aggiungi**. Viene visualizzata la finestra **Add tags (Aggiungi tag)**. 1. Digita un valore per **Tag key (Chiave tag)** e **Value (Valore)**. 1. Per aggiungere un altro tag, scegliere **Add another Tag (Aggiungi un altro tag)** e digitare un valore per **Tag key (Chiave tag)** e **Value (Valore)**. Ripetere questa operazione tutte le volte necessarie. 1. Scegliere **Aggiungi**. **Eliminazione di un tag da un'istanza database** 1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home) 1. Nel riquadro di navigazione, scegliere **Instances (Istanze)**. **Nota** Per filtrare l'elenco di istanze database nel riquadro **Instances (Istanze)**, digitare una stringa di testo nella casella **Filter instances (Filtra istanze)**. Vengono visualizzate solo le istanze database che contengono la stringa. 1. Scegli l'istanza database a cui applicare i tag. 1. Scegli **Instance actions (Operazioni istanza)** e successivamente **See details (Visualizza dettagli)**. 1. Nella sezione dei dettagli, scorrere verso il basso fino alla sezione **Tags (Tag)**. 1. Scegli il tag da eliminare. 1. Scegli **Remove (Rimuovi)** e successivamente **Remove (Rimuovi)** nella finestra **Remove tags (Rimuovi tag)**. # Taggare Neptune usando il AWS CLI È possibile aggiungere, elencare o rimuovere i tag per un'istanza database in Neptune utilizzando l' AWS CLI. + Per aggiungere uno o più tag a una risorsa Neptune, usa il comando. 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) + Per elencare i tag su una risorsa Neptune, usa il comando. 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) + Per rimuovere uno o più tag da una risorsa Neptune, usa il comando. 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) Per ulteriori informazioni su come creare la richiesta Amazon Resource Name (ARN), consultare [Costruzione di un ARN per Neptune](tagging-arns-constructing.md). # Taggare Neptune utilizzando l'API È possibile aggiungere, elencare o rimuovere i tag per un'istanza database utilizzando l'API di Neptune. + Per aggiungere un tag a una risorsa di Neptune, utilizza l'operazione [API_AddTagsToResource.html](API_AddTagsToResource.html). + Per elencare i tag assegnati a una risorsa di Neptune, utilizza l'operazione [API_ListTagsForResource.html](API_ListTagsForResource.html). + Per rimuovere i tag da una risorsa di Neptune, utilizza l'operazione [API_RemoveTagsFromResource.html](API_RemoveTagsFromResource.html). Per ulteriori informazioni su come creare l'ARN necessario, consultare [Costruzione di un ARN per Neptune](tagging-arns-constructing.md). Quando utilizzi XML con l'API di Neptune i tag seguono questo schema: ``` 1. 2. 3. 4. Project 5. Trinity 6. 7. 8. User 9. Jones 10. 11. 12. ``` La tabella riportata di seguito fornisce un elenco dei tag XML consentiti e le relative caratteristiche. I valori relativi a `Key` e `Value` fanno distinzione tra maiuscole e minuscole. Ad esempio, `project=Trinity` e `PROJECT=Trinity` sono due tag distinti. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/tagging-api.html) # Lavorare con gli amministratori ARNs in Amazon Neptune Le risorse create in Amazon Web Services sono identificate in modo univoco con un nome della risorsa Amazon (ARN). Per determinate operazioni Amazon Neptune è necessario identificare in modo univoco una risorsa Neptune specificandone l'ARN. **Importante** Amazon Neptune condivide il formato di Amazon ARNs RDS per le azioni amministrative che utilizzano il. [Documentazione di riferimento delle API di gestione](api.md) Neptune contiene e non contiene ARNs `rds` amministrativamente. `neptune-db` [Per i piani dati ARNs che identificano le risorse di dati di Neptune, vedere Specificazione delle risorse di dati.](iam-data-resources.md) **Topics** + [Costruzione di un ARN per Neptune](tagging-arns-constructing.md) + [Ottenere un ARN esistente in Amazon Neptune](#tagging-arns-getting) # Costruzione di un ARN per Neptune È possibile creare un ARN per una risorsa Amazon Neptune utilizzando la sintassi seguente. Tieni presente che Neptune condivide il formato di Amazon RDS. ARNs `arn:aws:rds::::` La tabella riportata di seguito mostra il formato da utilizzare quando si crea un ARN per un determinato tipo di risorsa amministrativa di Neptune. **** | Tipo di risorsa | Formato ARN | | --- | --- | | Istanza database | arn:aws:rds:: ** ** `:db:` ** Esempio: 
arn:aws:rds:us-east-2:123456789012:db:my-instance-1
| | Cluster DB | arn:aws:rds:: ** ** `:cluster:` ** Esempio: 
arn:aws:rds:us-east-2:123456789012:cluster:my-cluster-1
| | Sottoscrizione a eventi | arn:aws:rds:: ** ** `:es:` ** Esempio: 
arn:aws:rds:us-east-2:123456789012:es:my-subscription
| | DB parameter group (Gruppo di parametri database) | arn:aws:rds:: ** ** `:pg:` ** Esempio: 
arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs
| | DB cluster parameter group (Gruppo di parametri del cluster database) | arn:aws:rds:: ** ** `:cluster-pg:` ** Esempio: 
arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone
| | Snapshot cluster di database | arn:aws:: `rds:` ** ** `:cluster-snapshot:` ** Esempio: 
arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-snap-20160809
| | Gruppo di sottoreti DB | arn:aws:: `rds:` ** ** `:subgrp:` ** Esempio: 
arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10
| ## Ottenere un ARN esistente in Amazon Neptune Puoi ottenere l'ARN di una risorsa Neptune utilizzando l'API, Console di gestione AWS( AWS Command Line Interface )AWS CLI o Neptune. ### Ottenere un ARN esistente utilizzando il Console di gestione AWS Per ottenere un ARN utilizzando la console, accedere alla risorsa per cui ottenere un ARN e visualizzane i relativi dettagli. Ad esempio, per ottenere l'ARN per un'istanza database, scegli **Instances (Istanze)** nel riquadro di navigazione e successivamente l'istanza desiderata dall'elenco. L'ARN è indicato nella sezione **Instance Details (Dettagli istanza)**. ### Ottenere un ARN esistente utilizzando il AWS CLI Per usare AWS CLI per ottenere un ARN per una particolare risorsa di Neptune, usa il comando per quella risorsa. `describe` La tabella seguente mostra ogni AWS CLI comando e la proprietà ARN utilizzata con il comando per ottenere un ARN. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/tagging-arns.html) Ad esempio, il AWS CLI comando seguente ottiene l'ARN per un'istanza DB. **Example** Per Linux, OS X o Unix: ``` 1. aws neptune describe-db-instances \ 2. --db-instance-identifier DBInstanceIdentifier \ 3. --region us-west-2 ``` Per Windows: ``` 1. aws neptune describe-db-instances ^ 2. --db-instance-identifier DBInstanceIdentifier ^ 3. --region us-west-2 ``` ### Ottenere un ARN esistente utilizzando l'API Per ottenere un ARN per una determinata risorsa Neptune, chiama le operazioni dell'API seguenti e usa le proprietà ARN mostrate. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/tagging-arns.html)