As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Monitore GoldenGate os logs do Oracle usando a Amazon CloudWatch
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch"></a>

*Chithra Krishnamurthy, Amazon Web Services*

## Resumo
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-summary"></a>

 GoldenGate A Oracle fornece replicação em tempo real entre o Amazon Relational Database Service (Amazon RDS) para bancos de dados Oracle ou entre bancos de dados Oracle hospedados no Amazon Elastic Compute Cloud (Amazon EC2). Ele oferece suporte à replicação unidirecional e bidirecional.

Quando você usa GoldenGate para replicação, o monitoramento é fundamental para verificar se o GoldenGate processo está ativo e em execução, para garantir que os bancos de dados de origem e de destino estejam sincronizados.

Esse padrão explica as etapas para implementar o CloudWatch monitoramento da Amazon para um registro de GoldenGate erros e como definir alarmes para enviar notificações para eventos específicos, como`STOP`, por exemplo, para que você `ABEND` possa tomar as medidas apropriadas para retomar a replicação rapidamente.

## Pré-requisitos e limitações
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-prereqs"></a>

**Pré-requisitos **
+ GoldenGate instalado e configurado em uma instância do EC2, para que você possa configurar o CloudWatch monitoramento dessas instâncias do EC2. Se você quiser monitorar a replicação bidirecional GoldenGate em todas as regiões da AWS, deverá instalar o CloudWatch agente em cada instância do EC2 em que o GoldenGate processo está sendo executado.

**Limitações**
+ Esse padrão explica como monitorar o GoldenGate processo usando CloudWatch o. CloudWatch não monitora atrasos na replicação ou problemas de sincronização de dados durante a replicação. [Você deve executar consultas SQL separadas para monitorar o atraso na replicação ou os erros relacionados aos dados, conforme explicado na documentação. GoldenGate ](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html)

**Versões do produto**
+ Este documento é baseado na implementação do Oracle GoldenGate 19.1.0.0.4 para Oracle no Linux x86-64. No entanto, essa solução é aplicável a todas as versões principais do GoldenGate.

## Arquitetura
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-architecture"></a>

**Pilha de tecnologias de destino**
+ GoldenGate binários para Oracle instalados em uma instância EC2
+ Amazon CloudWatch
+ Amazon Simple Notification Service (Amazon SNS)

**Arquitetura de destino**

![Arquitetura de destino para monitorar GoldenGate registros na AWS](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/images/pattern-img/973a71d5-b6b3-4a2b-813e-cb4d8fd51ba5/images/1781aa9b-77b3-40c4-bc54-3cb91400899c.png)


## Ferramentas
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-tools"></a>

**Serviços da AWS**
+ [A Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) é um serviço de monitoramento usado nesse padrão para monitorar registros GoldenGate de erros.
+ O [Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) é um serviço de notificação de mensagens usado nesse padrão para enviar notificações por e-mail.

**Outras ferramentas**
+  GoldenGate O [Oracle](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html) é uma ferramenta de replicação de dados que você pode usar para o Amazon RDS for Oracle ou bancos de dados Oracle hospedados no Amazon EC2.

**Etapas de implementação de alto nível**

1. Crie uma função do AWS Identity and Access Management (IAM) para o CloudWatch agente.

1. Anexe a função do IAM à instância do EC2 em que os registros GoldenGate de erros são gerados.

1. Instale o CloudWatch agente na instância do EC2.

1. Configure os arquivos de configuração do CloudWatch agente: `awscli.conf` `awslogs.conf` e.

1. Inicie o CloudWatch agente.

1. Crie filtros métricos no grupo de logs.

1. Configuração do Amazon SNS.

1. Criar um alarme para o filtro de métricas. O Amazon SNS envia alertas por e-mail quando esses filtros capturam eventos.

Para obter instruções detalhadas, consulte a próxima seção.

## Épicos
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-epics"></a>

### Etapa 1. Crie uma função do IAM para o CloudWatch agente
<a name="step-1-create-an-iam-role-for-the-cloudwatch-agent"></a>


| Tarefa | Description | Habilidades necessárias | 
| --- | --- | --- | 
| Crie o perfil do IAM. | O acesso aos recursos da AWS exige permissões, então você cria funções do IAM para incluir as permissões necessárias para que cada servidor execute o CloudWatch agente.<br />Para criar um perfil do IAM:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | AWS geral | 

### Etapa 2. Anexe a função do IAM à instância do GoldenGate EC2
<a name="step-2-attach-the-iam-role-to-the-goldengate-ec2-instance"></a>


| Tarefa | Description | Habilidades necessárias | 
| --- | --- | --- | 
| Anexe a função do IAM à instância do EC2 em que os registros GoldenGate de erros são gerados. | Os registros de erro gerados por GoldenGate precisam ser preenchidos CloudWatch e monitorados, então você precisa anexar a função do IAM que você criou na etapa 1 à instância do EC2 em que GoldenGate está sendo executada.<br />Como anexar um perfil do IAM a uma instância:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | AWS geral | 

### Etapas 3-5. Instale e configure o CloudWatch agente na instância Goldengate EC2
<a name="steps-3-5-install-and-configure-the-cloudwatch-agent-on-the-goldengate-ec2-instance"></a>


| Tarefa | Description | Habilidades necessárias | 
| --- | --- | --- | 
| Instale o CloudWatch agente na instância do GoldenGate EC2. | Para instalar o agente, execute o comando:<pre>sudo yum install -y awslogs</pre> | AWS geral | 
| Edite os arquivos de configuração do agente. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | AWS geral | 
| Inicie o CloudWatch agente. | Para iniciar o agente, use o seguinte comando.<pre>$ sudo service awslogsd start</pre><br />Depois de iniciar o agente, você pode visualizar o grupo de registros no CloudWatch console. O fluxo de logs terá o conteúdo do arquivo. | AWS geral | 

### Etapa 6. Crie filtros métricos para o grupo de logs
<a name="step-6-create-metric-filters-for-the-log-group"></a>


| Tarefa | Description | Habilidades necessárias | 
| --- | --- | --- | 
| Crie filtros de métricas para as palavras-chave ABEND e STOPPED. | Quando você cria filtros métricos para o grupo de logs, sempre que os filtros são identificados no registro de erros, ele inicia um alarme e envia uma notificação por e-mail com base na configuração do Amazon SNS.<br />Para criar um filtro de métricas:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | CloudWatch | 

### Etapa 7. Configuração do Amazon SNS
<a name="step-7-set-up-amazon-sns"></a>


| Tarefa | Description | Habilidades necessárias | 
| --- | --- | --- | 
| Criar um tópico do SNS. | Nesta etapa, você configura o Amazon SNS para criar alarmes para os filtros métricos.<br />Para criar um tópico do SNS:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | Amazon SNS | 
| Crie uma assinatura. | Crie uma assinatura para o tópico:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html)<br />O Amazon SNS abre seu navegador da Web e exibe uma confirmação de assinatura com seu ID de assinatura. | Amazon SNS | 

### Etapa 8. Crie um alarme para enviar notificações para os filtros métricos
<a name="step-8-create-an-alarm-to-send-notifications-for-the-metric-filters"></a>


| Tarefa | Description | Habilidades necessárias | 
| --- | --- | --- | 
| Crie um alarme para o tópico do SNS. | Para criar um alarme com base em um filtro de métrica de grupo de logs:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html)<br />Após essas etapas, sempre que esses padrões forem detectados no arquivo de log de GoldenGate erros (`ggserr.log`) que você está monitorando, você receberá uma notificação por e-mail. | CloudWatch | 

## Solução de problemas
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-troubleshooting"></a>


| Problema | Solução | 
| --- | --- | 
| O fluxo de log do registro GoldenGate de erros não flui para dentro CloudWatch. | Verifique o `/etc/awslogs/awslogs.conf` arquivo para verificar o nome do arquivo, o nome do grupo de registros e o date/time formato. Você deve especificar o date/time para corresponder ao formato de data em`ggserror.log`. Caso contrário, o fluxo de log não fluirá para dentro CloudWatch. | 

## Recursos relacionados
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-resources"></a>
+ [ CloudWatch Documentação da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)
+ [Coleta de métricas e registros com o CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html)
+ [Documentação do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)