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à. # Monitora GoldenGate i log di Oracle utilizzando Amazon CloudWatch *Chithra Krishnamurthy, Amazon Web Services* ## Riepilogo Oracle GoldenGate fornisce la replica in tempo reale tra Amazon Relational Database Service (Amazon RDS) per database Oracle o tra database Oracle ospitati su Amazon Elastic Compute Cloud (Amazon EC2). Supporta la replica sia unidirezionale che bidirezionale. Quando si utilizza GoldenGate per la replica, il monitoraggio è fondamentale per verificare che il GoldenGate processo sia attivo e funzionante e per assicurarsi che i database di origine e di destinazione siano sincronizzati. Questo modello spiega i passaggi per implementare il CloudWatch monitoraggio di Amazon per un log degli GoldenGate errori e come impostare allarmi per inviare notifiche per eventi specifici, ad esempio intraprendere le azioni appropriate per riprendere rapidamente la replica. `STOP` `ABEND` ## Prerequisiti e limitazioni **Prerequisiti** + GoldenGate installato e configurato su un'istanza EC2, in modo da poter configurare il CloudWatch monitoraggio su tali istanze EC2. Se desideri monitorare la replica bidirezionale in tutte le GoldenGate regioni AWS, devi installare l' CloudWatch agente in ogni istanza EC2 in cui è in esecuzione il GoldenGate processo. **Limitazioni** + Questo schema spiega come monitorare il GoldenGate processo utilizzando CloudWatch. CloudWatch non monitora il ritardo di replica o i problemi di sincronizzazione dei dati durante la replica. [È necessario eseguire query SQL separate per monitorare il ritardo di replica o gli errori relativi ai dati, come spiegato nella documentazione. GoldenGate ](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html) **Versioni del prodotto** + Questo documento si basa sull'implementazione di Oracle GoldenGate 19.1.0.0.4 per Oracle su Linux x86-64. Tuttavia, questa soluzione è applicabile a tutte le versioni principali di. GoldenGate ## Architecture **Stack tecnologico Target** + GoldenGate binari per Oracle installati su un'istanza EC2 + Amazon CloudWatch + Amazon Simple Notification Service (Amazon SNS) **Architettura Target** ![Architettura Target per il monitoraggio dei GoldenGate log su AWS](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/973a71d5-b6b3-4a2b-813e-cb4d8fd51ba5/images/1781aa9b-77b3-40c4-bc54-3cb91400899c.png) ## Tools (Strumenti) **Servizi AWS** + [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) è un servizio di monitoraggio che viene utilizzato in questo schema per monitorare i log degli GoldenGate errori. + [Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) è un servizio di notifica dei messaggi utilizzato in questo modello per inviare notifiche e-mail. **Altri strumenti** + [Oracle GoldenGate ](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html) è uno strumento di replica dei dati che puoi utilizzare per i database Amazon RDS for Oracle o per i database Oracle ospitati su Amazon EC2. **Fasi di implementazione di alto livello** 1. Crea un ruolo AWS Identity and Access Management (IAM) per l' CloudWatch agente. 1. Collega il ruolo IAM all'istanza EC2 in cui vengono generati i log degli GoldenGate errori. 1. Installa l' CloudWatch agente sull'istanza EC2. 1. Configura i file di configurazione CloudWatch dell'agente: `awscli.conf` e`awslogs.conf`. 1. Avvia l' CloudWatch agente. 1. Crea filtri metrici nel gruppo di log. 1. Configura Amazon SNS. 1. Crea un allarme per i filtri metrici. Amazon SNS invia avvisi e-mail quando tali filtri rilevano eventi. Per istruzioni dettagliate, consulta la sezione successiva. ## Epiche ### Passaggio 1. Crea un ruolo IAM per l'agente CloudWatch | Operazione | Description | Competenze richieste | | --- | --- | --- | | Creare il ruolo IAM. | L'accesso alle risorse AWS richiede autorizzazioni, quindi puoi creare ruoli IAM per includere le autorizzazioni necessarie a ciascun server per eseguire l' CloudWatch agente.
Per creare il ruolo IAM:1. Accedi alla Console di gestione AWS, quindi apri la console di IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
2. Nel pannello di navigazione, scegli **Ruoli** e quindi **Crea ruolo**.
3. Per il **tipo di entità affidabile**, scegli il **servizio AWS**.
4. Per i **casi d'uso comuni**, scegli **EC2**, quindi scegli **Avanti**.
5. Nell'elenco delle politiche, seleziona la casella di controllo accanto a **CloudWatchAgentServerPolicy**. Se necessario, utilizzare la casella di ricerca per trovare la policy.
6. Scegli **Next (Successivo)**.
7. Per **Role name (Nome ruolo)**, inserire un nome per il nuovo ruolo, ad esempio `goldengate-cw-monitoring-role` o un altro nome che preferisci.
8. (Facoltativo) Per **Role Description (Descrizione ruolo)**, immetti una descrizione.
9. Conferma che sia **CloudWatchAgentServerPolicy**visualizzato sotto **Nome della politica**.
10. (Facoltativo) Aggiungi uno o più tag (coppie chiave-valore) per organizzare, tracciare o controllare l'accesso per questo ruolo, quindi scegli **Crea** ruolo. | Informazioni generali su AWS | ### Passaggio 2. Collega il ruolo IAM all' GoldenGate istanza EC2 | Operazione | Description | Competenze richieste | | --- | --- | --- | | Collega il ruolo IAM all'istanza EC2 in cui vengono generati i log degli GoldenGate errori. | I log degli errori generati da GoldenGate devono essere compilati CloudWatch e monitorati, quindi è necessario collegare il ruolo IAM creato nella fase 1 all'istanza EC2 in cui è in esecuzione. GoldenGate
Per associare un ruolo IAM a un'istanza:1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
2. Nel riquadro di navigazione, scegli **Istanze**, quindi trova l'istanza in cui GoldenGate è in esecuzione.
3. Seleziona l'istanza, quindi scegli il **ruolo **Azioni**, **Sicurezza**, Modifica IAM**.
4. Seleziona il ruolo IAM creato nel primo passaggio da collegare all'istanza, quindi scegli **Salva**. | Informazioni generali su AWS | ### Fasi 3-5. Installa e configura l' CloudWatch agente sull'istanza Goldengate EC2 | Operazione | Description | Competenze richieste | | --- | --- | --- | | Installa l' CloudWatch agente sull'istanza GoldenGate EC2. | Per installare l'agente, esegui il comando:
sudo yum install -y awslogs
| Informazioni generali su AWS | | Modifica i file di configurazione dell'agente. | 1. Eseguire il seguente comando seguente.
sudo su -

2. Modifica questo file per aggiornare la regione AWS, se necessario.
cat /etc/awslogs/conf
[plugins]
cwlogs = cwlogs
[default]
region = us-east-1

3. Modifica il `/etc/awslogs/awslogs.conf` file per aggiornare il nome del file, il nome del gruppo di log e il date/time formato. È necessario specificare il formato in cui deve corrispondere date/time alla data`ggserror.log`; in caso contrario, il flusso di log non verrà visualizzato CloudWatch. Esempio:
datetime_format = %Y-%m-%dT%H:%M:%S%z
file = /u03/oracle/oragg/ggserr.log
log_group_name = goldengate_monitor
| Informazioni generali su AWS | | Avvia l' CloudWatch agente. | Per avviare l'agente, utilizzare il seguente comando.
$ sudo service awslogsd start

Dopo aver avviato l'agente, è possibile visualizzare il gruppo di log nella CloudWatch console. Il flusso di log conterrà il contenuto del file. | Informazioni generali su AWS | ### Fase 6. Crea filtri metrici per il gruppo di log | Operazione | Description | Competenze richieste | | --- | --- | --- | | Crea filtri metrici per le parole chiave ABEND e STOPPED. | Quando crei filtri metrici per il gruppo di log, ogni volta che i filtri vengono identificati nel log degli errori, avvia un allarme e invia una notifica e-mail basata sulla configurazione di Amazon SNS.
Per creare filtri metrici:1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
2. Scegli il nome del gruppo di log.
3. Scegli **Actions** (Operazioni) e quindi **Create metric filter** (Crea filtro parametri).
4. Per il **pattern di filtro**, specificate uno schema come`ABEND`.
5. Scegli **Successivo** e poi inserisci un nome per il filtro.
6. In **Dettagli metrici**, per **Metric namespace**, inserisci un nome per lo spazio dei CloudWatch nomi in cui verrà pubblicata la metrica. Se questo spazio dei nomi non esiste già, assicurati che sia selezionato **Crea nuovo**.
7. Per **Valore metrico**, inserisci`1`, perché il filtro metrico conta le occorrenze delle parole chiave nel filtro.
8. ****Imposta l'unità su Nessuno.****
9. Scegli **Crea filtro parametri**. Puoi trovare il filtro dei parametri che hai creato nel riquadro di navigazione.
10. Crea un altro filtro metrico per il `STOPPED` pattern. All'interno di un gruppo di log, puoi creare più filtri metrici e impostare gli allarmi singolarmente. | CloudWatch | ### Fase 7. Configurazione di Amazon SNS | Operazione | Description | Competenze richieste | | --- | --- | --- | | Creare un argomento SNS. | In questo passaggio, configuri Amazon SNS per creare allarmi per i filtri metrici.
Per creare un argomento SNS:1. [Accedi alla console Amazon SNS da casahttps://console.aws.amazon.com/sns/.](https://console.aws.amazon.com/sns/home)
2. Nella casella **Crea argomento**, inserisci il nome di un argomento`goldengate-alert`, ad esempio, quindi scegli **Passaggio successivo**.
3. Per **Tipo**, scegliere **Standard**.
4. Vai in fondo al modulo e scegli **Creare un argomento**. La console apre la pagina nuovi argomenti **Dettagli**. | Amazon SNS | | Crea un abbonamento. | Per creare un abbonamento all'argomento:1. Nel pannello di navigazione sinistro scegli **Sottoscrizioni**.
2. Nella pagina **Sottoscrizioni** scegli **Crea sottoscrizione**.
3. Nella pagina **Crea abbonamento**, scegli il campo **Arn dell'argomento** per visualizzare un elenco degli argomenti del tuo account AWS.
4. Scegliere laargomento creato nei passaggi precedenti.
5. Per **Protocol**, scegliere **Email**.
6. In **Endpoint** immetti l'indirizzo e-mail utilizzabile per ricevere le notifiche.
7. Scegli **Crea abbonamento**. La console apre la pagina dei **dettagli** del nuovo abbonamento.
8. Controlla la tua casella di posta elettronica per ricevere un messaggio da AWS Notifications, quindi scegli **Conferma abbonamento** nell'e-mail.
Amazon SNS apre il browser Web e visualizza una conferma dell'abbonamento con il tuo ID abbonamento. | Amazon SNS | ### Fase 8. Crea un allarme per inviare notifiche per i filtri metrici | Operazione | Description | Competenze richieste | | --- | --- | --- | | Crea un allarme per l'argomento SNS. | Per creare un allarme basato su un filtro metrico per gruppi di log:1. Apri la console all' CloudWatch indirizzo. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)
2. Nel pannello di navigazione scegli **Logs** (Log), quindi **Log groups** (Gruppi di log).
3. Scegli il gruppo di log che include il filtro parametri.
4. Scegli **Metric filters** (Filtri parametri).
5. Nella scheda **Filtri metrici**, seleziona la casella di controllo relativa al filtro metrico su cui vuoi basare l'allarme.
6. Scegli **Crea allarme**.
7. Per **Condizioni**, specifica quanto segue in ogni sezione:For **Threshold type (Tipo di soglia)**, scegli **Static (Statica)**.Per **Whenever is..** , scegli **Maggiore**.Per **di...** , specificare **0**.
8. Scegli **Next (Successivo)**.
9. In **Notifica**:Per **Alarm state trigger** (Attivazione stato allarme), scegli **In alarm** (In allarme).Per **Invia notifica al seguente argomento SNS**, scegli **Seleziona un argomento esistente**.Nella casella e-mail, seleziona l'argomento Amazon SNS che hai creato nel passaggio precedente.
10. Scegli **Next (Successivo)**.
11. Per **Name and description (Nome e descrizione)**, inserisci un nome e una descrizione per il tuo allarme.Per la descrizione, puoi specificare il nome dell'istanza in modo che l'e-mail di notifica sia descrittiva.
12. Per **Anteprima e creazione**, verifica che la configurazione sia corretta, quindi scegli **Crea allarme**.
Dopo questi passaggi, ogni volta che questi schemi vengono rilevati nel file di registro degli GoldenGate errori (`ggserr.log`) che stai monitorando, riceverai una notifica via email. | CloudWatch | ## Risoluzione dei problemi | Problema | Soluzione | | --- | --- | | Il flusso di log proveniente dal registro GoldenGate degli errori non confluisce in CloudWatch. | Controlla il `/etc/awslogs/awslogs.conf` file per verificare il nome del file, il nome del gruppo di log e il date/time formato. È necessario specificare il date/time formato della data in cui deve corrispondere`ggserror.log`. In caso contrario, il flusso di log non confluirà in CloudWatch. | ## Risorse correlate + [ CloudWatch Documentazione Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) + [Raccolta di metriche e registri con l'agente CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) + [Documentazione Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)