# Tutorial: como configurar o monitoramento para o SAP ASE
Este tutorial demonstra como configurar o CloudWatch Application Insights para definir o monitoramento dos seus bancos de dados do SAP ASE. Você pode usar os painéis automáticos do CloudWatch Application Insights para visualizar os detalhes do problema, acelerar a solução de problemas e facilitar o tempo médio de resolução (MTTR) para seus bancos de dados do SAP ASE.
**Topics**
+ [Ambientes compatíveis](#appinsights-tutorial-sap-ase-supported-environments)
+ [Sistemas operacionais compatíveis](#appinsights-tutorial-sap-ase-supported-os)
+ [Recursos](#appinsights-tutorial-sap-ase-features)
+ [Pré-requisitos](#appinsights-tutorial-sap-ase-prerequisites)
+ [Configurar o monitoramento](#appinsights-tutorial-sap-ase-set-up)
+ [Gerenciar monitoramento](#appinsights-tutorial-sap-ase-manage)
+ [Configurar o limite de alarmes](#appinsights-tutorial-sap-hana-configure-alarm-threshold)
+ [Visualizar e solucionar problemas do SAP ASE detectados pelo Application Insights](#appinsights-tutorial-sap-ase-troubleshooting-problems)
+ [Solução de problemas do Application Insights](#appinsights-tutorial-sap-ase-troubleshooting-health-dashboard)
## Ambientes compatíveis
O CloudWatch Application Insights é compatível com a implantação de recursos da AWS para os sistemas e os padrões a seguir. Você fornece e instala o software de banco de dados do SAP ASE e o software de aplicação do SAP compatível.
+ **Um ou mais bancos de dados do SAP ASE em uma única instância do Amazon EC2**: SAP ASE em uma arquitetura de aumento vertical de escala de nó único.
+ **Configuração de alta disponibilidade do banco de dados do SAP ASE entre zonas de disponibilidade**: SAP ASE com alta disponibilidade configurada em duas zonas de disponibilidade usando o clustering SUSE/RHEL.
**nota**
O CloudWatch Application Insights é compatível apenas com ambientes ASE HA com um único ID de sistema SAP (SID). Se vários SIDs do ASE HA estiverem conectados, o monitoramento será configurado apenas para o primeiro SID detectado.
## Sistemas operacionais compatíveis
O CloudWatch Application Insights para SAP ASE é compatível com a arquitetura x86-64 nos seguintes sistemas operacionais:
+ SuSE Linux 12 SP4
+ SuSE Linux 12 SP5
+ SUSE Linux 15
+ SuSE Linux 15 SP1
+ SuSE Linux 15 SP2
+ SuSE Linux 15 SP3
+ SuSE Linux 15 SP4
+ SuSE Linux 15 SP1 para SAP
+ SuSE Linux 15 SP2 para SAP
+ SuSE Linux 15 SP3 para SAP
+ SuSE Linux 15 SP4 para SAP
+ SuSE Linux 12 SP4 para SAP
+ SuSE Linux 12 SP5 para SAP
+ RedHat Linux 7.6
+ RedHat Linux 7.7
+ RedHat Linux 7.9
+ RedHat Linux 8.1
+ RedHat Linux 8.4
+ RedHat Linux 8.6
## Recursos
O CloudWatch Application Insights para SAP ASE oferece os seguintes recursos:
+ Detecção automática da workload do SAP ASE
+ Criação automática de alarmes do SAP ASE com base em um limite estático
+ Criação automática de alarmes do SAP ASE com base na detecção de anomalias
+ Reconhecimento automático de padrões de log do SAP ASE
+ Painel de controle de integridade do SAP ASE
+ Painel de problemas para o SAP ASE
## Pré-requisitos
Você deve executar os seguintes pré-requisitos para configurar um banco de dados do SAP ASE com o CloudWatch Application Insights:
+ **Parâmetros de configuração do SAP ASE**: os seguintes parâmetros de configuração devem ser ativados em seu banco de dados ASE: `"enable monitoring"`, `"sql text pipe max messages"`, `"sql text pipe active"`. Isso permite que o CloudWatch Application Insights forneça recursos completos de monitoramento para o seu banco de dados. Se essas configurações não estiverem ativadas no seu banco de dados do ASE, o Application Insights as ativará automaticamente para coletar as métricas necessárias para permitir o monitoramento.
+ **Usuário do banco de dados do SAP ASE**: o usuário do banco de dados fornecido durante a integração do Application Insights deve ter permissão para acessar o seguinte:
+ Tabelas de sistema no banco de dados mestre e nos bancos de dados de usuários (locatários)
+ Tabelas de monitoramento
+ **SAPHostCtrl**: instalar e configurar o SAPHostCtrl em sua instância do Amazon EC2.
+ **Agente do Amazon CloudWatch**: verificar que um agente preexistente do CloudWatch não esteja em execução na sua instância do Amazon EC2. Se você tiver o agente do CloudWatch instalado, certifique-se de remover do seu arquivo de configuração existente a configuração dos recursos que você está usando no CloudWatch Application Insights, para evitar conflito de mesclagem. Para obter mais informações, consulte [Criar ou editar manualmente o arquivo de configuração do atendente do CloudWatch](CloudWatch-Agent-Configuration-File-Details.md).
+ **Habilitação do AWS Systems Manager**: instale o agente do SSM em suas instâncias e habilite as instâncias habilitadas para SSM. Para obter mais informações sobre como instalar o SSM Agent, consulte [Trabalhar com o SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent.html) no *Guia do usuário do AWS Systems Manager*.
+ **Perfis de instância do Amazon EC2**: você deve anexar os perfis de instância do Amazon EC2 a seguir para configurar seu banco de dados.
+ Você deve anexar o perfil do `AmazonSSMManagedInstanceCore` para habilitar o Systems Manager. Para obter mais informações, consulte [exemplos de políticas baseadas em identidade do AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html).
+ Deve-se anexar o `CloudWatchAgentServerPolicy` para permitir que métricas e logs de instância sejam emitidos por meio do CloudWatch. Para obter mais informações, consulte [Criar perfis e usuários do IAM para uso com o agente do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-iam-roles-for-cloudwatch-agent.html).
+ Você deve anexar a seguinte política em linha do IAM à função de instância do Amazon EC2 para leitura da senha armazenada no AWS Secrets Manager. Para obter mais informações sobre políticas em linha, consulte [Políticas em linha](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) no *Guia do usuário do AWS Identity and Access Management*.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:ApplicationInsights-*"
}
]
}
```
------
+ **AWS Resource Groups**: você deve criar um grupo de recursos que inclua todos os recursos da AWS associados usados pela sua pilha de aplicações para integrar suas aplicações ao CloudWatch Application Insights. Isso inclui instâncias do Amazon EC2 e volumes do Amazon EBS que executam seu banco de dados do SAP ASE. Se houver vários bancos de dados por conta, recomendamos que você crie um grupo de recursos que inclua os recursos da AWS de cada sistema de banco de dados do SAP ASE.
+ **Permissões do IAM**: para usuários não administradores:
+ é necessário criar uma política do AWS Identity and Access Management (IAM) que permita ao Application Insights criar uma função vinculada ao serviço e anexá-la à sua identidade do usuário. Para obter as etapas para anexar a política, consulte [Política do IAM para o CloudWatch Application Insights](appinsights-iam.md).
+ O usuário deve ter a permissão para criar um segredo no AWS Secrets Manager para armazenar as credenciais do usuário do banco de dados. Para obter mais informações, consulte [Exemplo: permissão para criar segredos](https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access_examples.html#auth-and-access_examples_create).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:CreateSecret"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:ApplicationInsights-*"
}
]
}
```
------
+ **Perfil vinculado ao serviço**: o Application Insights usa os perfis vinculadas ao serviço do AWS Identity and Access Management (IAM). Ao criar a primeira aplicação com o Application Insights, é criada uma função vinculada ao serviço no console do Application Insights. Para obter mais informações, consulte [Usar funções vinculadas ao serviço do CloudWatch Application Insights](CHAP_using-service-linked-roles-appinsights.md).
## Configurar o monitoramento em seu banco de dados do SAP ASE
Use as etapas a seguir para configurar o monitoramento do seu banco de dados do SAP ASE
1. [Abra o console do CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. No painel de navegação esquerdo, em **Insights**, escolha **Application Insights**.
1. A página **Application Insights** exibe a lista de aplicações que são monitoradas pelo Application Insights e o status de monitoramento de cada aplicação. No canto superior direito, escolha **Add an application** (Adicionar uma aplicação).
1. Na página **Especificar detalhes da aplicação**, na lista suspensa em **Grupo de recursos**, selecione o grupo de recursos da AWS que contém os recursos do banco de dados do SAP ASE. Se ainda não tiver criado um grupo de recursos para a aplicação, você poderá criar um escolhendo **Create new resource group** (Criar grupo de recursos) na lista suspensa **Resource group** (Grupo de recursos). Para obter mais informações sobre grupos de recursos, consulte o [https://docs.aws.amazon.com/ARG/latest/userguide/resource-groups.html](https://docs.aws.amazon.com/ARG/latest/userguide/resource-groups.html)
1. Em **Monitor CloudWatch Events** (Monitorar CloudWatch Events), marque a caixa de seleção para integrar o monitoramento do Application Insights com o CloudWatch Events para obter insights do Amazon EBS, Amazon EC2, AWS CodeDeploy, Amazon ECS, APIs e notificações do AWS Health, Amazon RDS, Amazon S3 e AWS Step Functions.
1. Em **Integrar com o OpsCenter do AWS Systems Manager**, marque a caixa de seleção ao lado de **Gerar OpsItems do OpsCenter do AWS Systems Manager para ações corretivas** para visualizar e receber notificações quando forem detectados problemas nas aplicações selecionadas. Para rastrear as operações realizadas para resolver itens de trabalho operacionais denominados OpsItems, que são relacionados aos recursos da AWS, forneça um ARN do tópico do SNS.
1. É possível, opcionalmente, inserir etiquetas para ajudar a identificar e organizar seus recursos. O CloudWatch Application Insights é compatível com os grupos de recursos baseados em tags e em filas do CloudFormation, exceto os grupos do Application Auto Scaling). Para obter mais informações, consulte [Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) (Editor de etiquetas) no *Guia do usuário do AWS Resource Groups*.
1. Escolha **Next** (Próximo) para continuar a configurar o monitoramento.
1. Na página **Revisar componentes detectados**, são listados os componentes monitorados e suas workloads automaticamente detectadas pelo CloudWatch Application Insights.
**nota**
Os componentes que contêm uma workload detectada de alta disponibilidade do SAP ASE são compatíveis com apenas uma workload em um componente. Os componentes que contêm uma workload de nó único do SAP ASE detectada são compatíveis com várias workloads, mas você não pode adicionar ou remover workloads. Todas as workloads detectadas automaticamente serão monitoradas.
1. Escolha **Próximo**.
1. Na página **Especificar detalhes do componente**, insira o nome de usuário e a senha dos bancos de dados do SAP ASE.
1. Revise a configuração de monitoramento de aplicações e escolha **Submit** (Enviar).
1. A página de detalhes da aplicação se abrirá, e nela serápossível visualizar o **Resumo da aplicação**, a lista de **Componentes e workloads monitoradas** e de **Componentes e workloads não monitoradas**. Ao selecionar o botão de opção ao lado de um componente ou workload, também será possível visualizar o **Histórico de configuração**, os **Padrões de log** e quaisquer **Tags** criadas. Quando você envia sua configuração, sua conta implementa todas as métricas e alarmes para o sistema do SAP ASE, o que pode levar até duas horas.
## Gerenciar o monitoramento do seu banco de dados do SAP ASE
Você pode gerenciar credenciais de usuário, métricas e caminhos de log para o banco de dados do SAP ASE executando as seguintes etapas:
1. [Abra o console do CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. No painel de navegação esquerdo, em **Insights**, escolha **Application Insights**.
1. A página **Application Insights** exibe a lista de aplicações que são monitoradas pelo Application Insights e o status de monitoramento de cada aplicação.
1. Em **Componentes monitorados**, selecione o botão ao lado do nome do componente. Em seguida, escolha **Manage monitoring** (Gerenciar o monitoramento).
1. Em **EC2 instance group logs** (Logs de grupos de instâncias do EC2), é possível atualizar o caminho de log existente, o conjunto de padrões de log e o nome do grupo de logs. Além disso, você pode adicionar até outros três **Application logs** (Logs de aplicações).
1. Em **Métricas**, você pode escolher as métricas do SAP ASE de acordo com suas necessidades. Os nomes de métricas do SAP ASE são prefixados com `asedb`. Você pode adicionar até 60 métricas por componente.
1. Em **Configuração do ASE**, insira o nome de usuário e a senha do banco de dados do SAP ASE. Esse é o nome de usuário e a senha que o agente do Amazon CloudWatch usa para se conectar ao banco de dados do SAP ASE.
1. Em **Custom alarms** (Alarmes personalizados), é possível pode adicionar alarmes extras para serem monitorados pelo CloudWatch Application Insights.
1. Revise a configuração de monitoramento de aplicações e escolha **Submit** (Enviar). Quando você envia sua configuração, sua conta atualiza todas as métricas e alarmes do sistema SAP HANA, o que pode levar até duas horas.
## Configurar o limite de alarmes
O CloudWatch Application Insights cria automaticamente uma métrica do Amazon CloudWatch para o alarme observar, bem como o limite dessa métrica. O alarme passará para o estado `ALARM ` quando a métrica ultrapassar o limite de um número especificado de períodos de avaliação. Observe que essas configurações não são retidas pelo Application Insights.
Para editar um alarme de uma única métrica, execute as seguintes etapas:
1. [Abra o console do CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. No painel de navegação à esquerda, escolha **Alarms** (Alarmes), **All alarms** (Todos os alarmes).
1. Selecione o botão ao lado do alarme criado automaticamente pelo CloudWatch Application Insights. Em seguida, escolha **Actions** (Ações) e selecione **Edit** (Editar) no menu suspenso.
1. Edite os seguintes parâmetros em **Metric** (Métrica).
1. Em **Statistic** (Estatística), escolha uma das estatísticas ou um dos percentis predefinidos ou especifique um percentil personalizado. Por exemplo, `p95.45`.
1. Em **Period (Período)**, escolha os períodos de avaliação do alarme. Ao avaliar o alarme, todos cada período é agregado em um único ponto de dados.
1. Edite os seguintes parâmetros em **Conditions** (Condições).
1. Escolha se a métrica deve ser maior que, menor que ou igual ao limite.
1. Especifique o valor do limite.
1. Em **Additional Configuration** (Configuração adicional) edite os parâmetros a seguir.
1. Em **Datapoints to alarm** (Datapoints para alarme), especifique o número de pontos de dados, ou períodos de avaliação, que devem estar no estado `ALARM` para iniciar o alarme. Quando os dois valores correspondem, é criado um alarme que entra no estado `ALARM` se o número designado de períodos consecutivos for excedido. Para criar um alarme `m` de `n`, especifique um número menor para o primeiro valor do que para o segundo valor. Para obter mais informações sobre como a avaliação de alarmes, consulte [Avaliação de um alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html#alarm-evaluation).
1. Para o **Missing data treatment** (Tratamento de dados ausentes), escolha como deseja que o alarme se comporte quando alguns pontos de dados estiverem ausentes. Para obter mais informações, consulte [Configurar como alarmes do CloudWatch tratam dados ausentes.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html#alarms-and-missing-data)
1. Se o alarme usar um percentil como estatística monitorada, uma caixa **Percentiles with low samples (Percentis com amostras baixas)** será exibida. Escolha se deseja avaliar ou ignorar casos com taxas de amostra baixas. Se você escolher **ignore (maintain the alarm state) (ignorar (manter o estado do alarme))**, o estado do alarme atual será sempre mantido quando o tamanho da amostra for muito baixo. Para obter mais informações sobre percentis com amostras baixas, consulte [Alarmes baseados em percentil e exemplos de poucos dados](percentiles-with-low-samples.md).
1. Escolha **Próximo**.
1. Em **Notification (Notificação)**, selecione um tópico do SNS para notificar quando o alarme estiver no estado `ALARM`, `OK` ou `INSUFFICIENT_DATA`.
1. Escolha **Create alarm** (Criar alarme).
## Visualizar e solucionar problemas do SAP ASE detectados pelo Application Insights
Esta seção ajuda você a resolver problemas comuns de solução de problemas que ocorrem quando você configura o monitoramento do SAP ASE no Application Insights.
**Erros do servidor de backup do SAP ASE**
Você pode identificar a mensagem de erro ao verificar o painel criado dinamicamente. O painel mostra a mensagem de erro relatada no servidor de backup do SAP ASE. Para obter mais detalhes sobre os logs do servidor de backup do SAP ASE, consulte [SAP Documentation Backup Server Error Logging](https://help.sap.com/docs/SAP_ASE/aa939a27edb34f019f71cc47b9c0fd9a/a7aeb8b1bc2b10149ccf99b95687a64c.html).
**Transações de longa duração do SAP ASE**
Identifique a transação de longa duração e confirme se ela pode ser interrompida ou se o tempo de execução é intencional. Para obter mais detalhes, consulte [2180410 - How to display transaction log records for long running transactions? - SAP ASE](https://userapps.support.sap.com/sap/support/knowledge/en/2180410).
**Conexões de usuário do SAP ASE**
Verifique se o banco de dados do SAP ASE está dimensionado adequadamente para a workload que você pretende executar no banco de dados. Para obter mais detalhes, consulte [Configuring User Connections](https://help.sap.com/docs/help/061ec8a5739842df9e505d8944fae8e2/9ea258fceaaa496eb80e17d3d5694ff6.html) na documentação do SAP.
**Espaço em disco do SAP ASE**
Você pode identificar a camada do banco de dados que está causando o problema verificando o painel criado dinamicamente. O painel mostra as métricas relacionadas e os trechos de arquivos de log. É importante entender a causa do crescimento do disco e, quando aplicável, aumentar o tamanho do disco físico, o espaço em disco alocado ou ambos. Para obter mais detalhes, consulte a [Documentação do SAP sobre redimensionamento de disco](https://help.sap.com/docs/SAP_ASE/e0d4539d39c34f52ae9ef822c2060077/ab22db00bc2b1014ad3ce047bbf117d7.html) na documentação do SAP.
## Solução de problemas do Application Insights para SAP ASE
Esta seção fornece etapas para ajudar você a resolver erros comuns retornados pelo painel do Application Insights.
| Erro | Erro retornado | Causa-raiz | Resolução |
| --- | --- | --- | --- |
| Não é possível adicionar mais de 60 métricas de monitoramento. | `Component cannot have more than 60 monitored metric` | O limite atual de métricas é de 60 métricas monitoradas por componente. | Remova métricas desnecessárias para aderir ao limite. |
| Nenhuma métrica ou alarme do SAP aparece após o processo de integração | O comando `run` no `AWS-ConfigureAWSPackage` falhou no AWS Systems Manager. A saída mostra o erro: `CT-LIBRARY error:``ct_connect(): protocol specific layer: external error: The attempt to connect to the server failed` | O nome de usuário e a senha podem estar incorretos. | Verifique se o nome de usuário e a senha são válidos e, em seguida, execute novamente o processo de integração. |