AWS O Mainframe Modernization Service (experiência em Managed Runtime Environment) não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (experiência autogerenciada). Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

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á.

# Configure o AWS Transform for mainframe Runtime (no Amazon EC2) Amazon Alarms CloudWatch
<a name="ba-cw-alarms-ec2"></a>

Você pode configurar CloudWatch para receber o registro do aplicativo e adicionar um alarme para avisá-lo sobre possíveis erros. Isso permite que você tenha notificações mais visíveis sempre que suas aplicações implantadas encontrarem exceções. As seções a seguir ajudam você a entender e aprender sobre a configuração de CloudWatch registro e configuração de alarmes.

## Ativar CloudWatch registro
<a name="ba-cw-log-deploy"></a>

Para ativar o CloudWatch registro, crie um `logback-cloudwatch.xml` arquivo na pasta config usando o modelo de configuração fornecido na seção a seguir. Em seguida, faça referência a esse arquivo no `application-main.yml` arquivo descomentando as seguintes linhas:

```
# logging:
#  config: classpath:logback-cloudwatch.xml
```

 Depois de descomentar essas linhas, o CloudWatch registro será ativado e poderá ser configurado posteriormente conforme explicado nas seções a seguir.

## Configuração do CloudWatch registro
<a name="config-cw-log"></a>

Use o modelo a seguir para criar o `logback-cloudwatch.xml` arquivo:

```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration>
<configuration>

    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%date{yyyy-MM-dd HH:mm:ss.SSS,UTC}  %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable</pattern>
        </encoder>
    </appender>

    <appender name="cloudwatch" class="com.netfective.bluage.runtime.cloudwatchlogger.CloudWatchAppender">
        <logGroup>BluAgeRuntimeOnEC2-Logs</logGroup>
        <logStream>%date{yyyy-MM-dd,UTC}.%instanceId.%uuid</logStream>
        <layout>
            <pattern>%date{yyyy-MM-dd HH:mm:ss.SSS,UTC}  %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable</pattern>
        </layout>
        <appender-ref ref="console" />
    </appender>

    <root level="INFO">
        <appender-ref ref="cloudwatch" />
    </root>
</configuration>
```

Tudo fora do <appender name="cloudwatch"/> elemento é uma configuração padrão de logback. Há dois anexadores neste arquivo: um anexador de console para enviar registros para o console e um CloudWatch anexador para o qual enviar registros. CloudWatch

O atributo `level` no elemento `root` especifica o nível de log de toda a aplicação.

Os valores necessários dentro da tag <appender name="cloudwatch"/> são: 
+ <logGroup/>:Define o nome do grupo de registros em CloudWatch. Se o valor não for especificado, o padrão será `BluAgeRuntimeOnEC2-Logs`. Se o grupo de logs não existir, ele será criado automaticamente. Esse comportamento pode ser alterado por meio da configuração, que será abordada a seguir.
+ <logStream/>: define o nome do LogStream (dentro do grupo de registros) em. CloudWatch

Valores opcionais: 
+ <region/>: Substitui a região na qual o fluxo de logs será gravado. Por padrão, os logs vão para a mesma região que a instância do EC2.
+ <layout/>: o padrão que as mensagens de log usarão. 
+ <maxbatchsize/>: o número máximo de mensagens de registro a serem enviadas CloudWatch por operação.
+ <maxbatchtimemillis/>: o tempo em milissegundos para permitir que CloudWatch os registros sejam gravados.
+ <maxqueuewaittimemillis/>: o tempo em milissegundos para tentar inserir solicitações na fila de logs interna.
+ <internalqueuesize/>: o tamanho máximo da fila interna.
+ <createlogdests/>: crie um grupo de logs e um fluxo de logs, se eles não existirem.
+ <initialwaittimemillis/>: a quantidade de tempo em que você deseja que o thread permaneça suspenso na inicialização. Essa espera inicial permite um acúmulo inicial de logs.
+ <maxeventmessagesize/>: o tamanho máximo de um evento de logs. Os logs que excederem esse tamanho não serão enviados.
+ <truncateeventmessages/>: trunque as mensagens que são muito longas.
+ <printrejectedevents/>: Ative o anexador de emergência.

## CloudWatch configuração
<a name="cw-setup"></a>

Para que a configuração acima envie corretamente os registros para CloudWatch, atualize sua função de perfil de instância IAM do Amazon EC2 para conceder permissões adicionais para o grupo de logs `BluAgeRuntimeOnEC2-Logs` e seus fluxos de log: 
+ `logs:CreateLogStream`
+ `logs:DescribeLogStreams`
+ `logs:CreateLogGroup`
+ `logs:PutLogEvents`
+ `logs:DescribeLogGroups`

## Configuração de alarmes
<a name="alarm-setup"></a>

Graças aos CloudWatch registros, você pode configurar diferentes métricas e alarmes, dependendo do seu aplicativo e de suas necessidades. Especificamente, você pode configurar alarmes proativos para alertas de uso, para ser avisado no caso de erros que possam colocar a aplicação em um período de carência (e, no final, impedir que ele funcione). Para fazer isso, você pode adicionar uma métrica relacionada à string “Erro C5001" nos registros, que destaca os erros na conexão com o sistema de controle AWS Transform for mainframe. Depois, você poderá definir um alarme que reaja a essa métrica.