

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

# Monitorar sistemas de arquivos do FSx para Windows File Server
<a name="monitoring_overview"></a>

O monitoramento é uma parte importante da manutenção da confiabilidade, disponibilidade e desempenho do FSx para Windows File Server e de suas soluções da AWS. Você deve coletar dados de monitoramento de todas as partes de sua solução da AWS para facilitar a depuração de uma falha, caso ela ocorra. No entanto, antes de iniciar o monitoramento do FSx para Windows File Server, é necessário criar um plano que inclua respostas às seguintes perguntas:
+ Quais são seus objetivos de monitoramento?
+ Quais recursos você vai monitorar?
+ Com que frequência você vai monitorar esses recursos?
+ Quais ferramentas de monitoramento você usará?
+ Quem realizará o monitoramento das tarefas?
+ Quem deve ser notificado quando algo der errado?

Para obter mais informações sobre o registro e o monitoramento no FSx para Windows File Server, consulte os tópicos a seguir.

**Topics**
+ [Monitoramento automático e manual](#monitoring_automated_manual)
+ [Monitorar com o Amazon CloudWatch](monitoring-cloudwatch.md)
+ [Registrar em log as chamadas de API do Amazon FSx para Windows File Server usando o AWS CloudTrail](logging-using-cloudtrail.md)

## Monitoramento automático e manual
<a name="monitoring_automated_manual"></a>

A AWS fornece várias ferramentas que você pode usar para monitorar o FSx para Windows File Server. Você pode configurar algumas dessas ferramentas para fazer o monitoramento para você, enquanto outras ferramentas exigem intervenção manual. Recomendamos que as tarefas de monitoramento sejam automatizadas ao máximo possível.

### Ferramentas de monitoramento automatizadas
<a name="monitoring_automated_tools"></a>

Você pode usar as seguintes ferramentas de monitoramento automatizadas para observar o FSx para Windows File Server e gerar relatórios quando algo estiver errado:
+ **Amazon CloudWatch Alarms**: observe uma única métrica ao longo de um período que você especificar e realize uma ou mais ações com base no valor da métrica em relação a um limite ao longo de vários períodos. A ação é uma notificação enviada para um tópico do Amazon Simple Notification Service (Amazon SNS) ou uma política do Amazon EC2 Auto Scaling. Os alarmes do CloudWatch não invocam ações simplesmente por estarem em um estado específico. O estado deve ter sido alterado e mantido por um número específico de períodos. Para obter mais informações, consulte [Monitorar com o Amazon CloudWatch](monitoring-cloudwatch.md).
+ **Amazon CloudWatch Logs**: monitore, armazene e acesse seus arquivos de log do AWS CloudTrail ou de outras origens. Para obter mais informações, consulte [O que é o Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) no *Guia do usuário do Amazon CloudWatch Logs*.
+ **Monitoramento de log AWS CloudTrail**: compartilhe arquivos de log entre contas, monitore os arquivos de log do CloudTrail em tempo real enviando-os para o CloudWatch Logs, escreva aplicações de processamento de logs em Java e confirme se os arquivos de log não foram alterados após a entrega pelo CloudTrail. Para obter mais informações, consulte [Trabalhando com arquivos de log do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-working-with-log-files.html) no *Guia do usuário do AWS CloudTrail*. 

### Ferramentas de monitoramento manual
<a name="monitoring_manual_tools"></a>

Outra parte importante do monitoramento do FSx para Windows File Server é o monitoramento manual dos itens que os alarmes do Amazon CloudWatch não abrangem. Os painéis do FSx para Windows File Server, do CloudWatch e de outro console da AWS apresentam uma visão rápida do estado do seu ambiente da AWS.

O painel **Monitoramento e desempenho** do Amazon FSx mostra:
+ Avisos atuais e alarmes do CloudWatch
+ Um resumo da atividade do sistema de arquivos
+ Capacidade e utilização de armazenamento do sistema de arquivos
+ Desempenho do servidor de arquivos e do volume de armazenamento
+ Alarmes do CloudWatch

O painel do Amazon CloudWatch mostra:
+ Alertas e status atual
+ Gráficos de alertas e recursos
+ Estado de integridade do serviço

Além disso, é possível usar o CloudWatch para fazer o seguinte:
+ Crie [Painéis personalizados](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) para monitorar os serviços que você usa.
+ Colocar em gráfico dados de métrica para solucionar problemas e descobrir tendências.
+ Pesquise e procure todas as métricas de recursos da AWS.
+ Criar e editar alertas para ser notificado sobre problemas.

Para obter mais informações sobre o painel de **Monitoramento e performance** do Amazon FSx, consulte [Usar métricas do sistema de arquivos](monitoring-cloudwatch.md#how_to_use_metrics).

# Monitorar com o Amazon CloudWatch
<a name="monitoring-cloudwatch"></a>

O Amazon CloudWatch coleta e processa dados brutos do seu FSx para Windows File Server em métricas legíveis e praticamente em tempo real. Essas estatísticas são retidas por um período de 15 meses, proporcionando acesso a informações históricas e ajudando a obter perspectivas sobre o desempenho do seu fluxo de trabalho ou sistema de arquivos.

O FSx para Windows File Server publica métricas do CloudWatch nos seguintes domínios:
+ As métricas de E/S de rede medem a atividade entre os clientes que acessam o sistema de arquivos e o servidor de arquivos.
+ As métricas do servidor de arquivos medem a utilização do throughput da rede, a CPU e a memória do servidor de arquivos, o throughput do disco do servidor de arquivos e a utilização de IOPS.
+ As métricas de E/S de disco medem a atividade entre o servidor de arquivos e os volumes de armazenamento.
+ As métricas de volume de armazenamento medem a utilização do throughput de disco para volumes de armazenamento HDD e a utilização de IOPS para volumes de armazenamento SSD.
+ As métricas de capacidade de armazenamento medem o uso do armazenamento, incluindo a economia de armazenamento devido à eliminação de duplicação dos dados.

O diagrama a seguir ilustra um sistema de arquivos do FSx para Windows File Server, seus componentes e os domínios de métrica.

![\[O FSx para Windows File Server relata métricas no CloudWatch que monitoram a E/S de rede, a performance do servidor de arquivos e a performance do volume de armazenamento.\]](http://docs.aws.amazon.com/pt_br/fsx/latest/WindowsGuide/images/metrics-overview-FSxW.png)


Por padrão, o Amazon FSx para Windows File Server envia dados de métricas para o CloudWatch em períodos de 1 minuto, com as seguintes exceções que são emitidas em intervalos de 5 minutos:
+ `FileServerDiskThroughputBalance`
+ `FileServerDiskIopsBalance`

Para obter mais informações sobre o CloudWatch, consulte [O que é o Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) no *Manual do usuário do Amazon CloudWatch*.

As métricas podem não ser publicadas para sistemas de arquivos single-AZ durante a manutenção do sistema de arquivos ou a substituição de componentes da infraestrutura e para sistemas de arquivos multi-AZ durante o failover e o failback entre os servidores de arquivos primário e secundário.

Algumas métricas do Amazon FSx CloudWatch são relatadas como *Bytes* brutos. Os bytes não são arredondados para um múltiplo decimal ou binário da unidade.

**Topics**
+ [Métricas e dimensões do CloudWatch](#fsx-windows-metrics)
+ [Usar métricas do sistema de arquivos](#how_to_use_metrics)
+ [Avisos e recomendações de performance](#performance-insights-FSxW)
+ [Acesso a métricas de sistema de arquivos](accessingmetrics.md)
+ [Criar alarmes do CloudWatch](creating_alarms.md)

## Métricas e dimensões do CloudWatch
<a name="fsx-windows-metrics"></a>

O FSx para Windows File Server publica as seguintes métricas no namespace do `AWS/FSx` no Amazon CloudWatch para todos os sistemas de arquivos:
+ `DataReadBytes`
+ `DataWriteBytes`
+ `DataReadOperations`
+ `DataWriteOperations`
+ `MetadataOperations`
+ `FreeStorageCapacity`

O FSx para Windows File Server publica as métricas descritas nas seções a seguir no namespace do `AWS/FSx` no Amazon CloudWatch para sistemas de arquivos configurados com uma capacidade de throughput de pelo menos 32 MBps.

### Métricas de E/S de rede
<a name="fsx-networkio-metrics"></a>

O namespace do `AWS/FSx` inclui as seguintes métricas de E/S de rede.


| Métrica | Descrição | 
| --- | --- | 
| DataReadBytes |  O número de bytes para operações de leitura para clientes que acessam o sistema de arquivos. Unidades: bytes Estatísticas válidas: `Sum`  | 
| DataWriteBytes |  O número de bytes para operações de gravação para clientes que acessam o sistema de arquivos. Unidades: bytes Estatísticas válidas: `Sum`  | 
| DataReadOperations |  O número de operações de leitura para clientes que acessam o sistema de arquivos. Unidades: contagem Estatísticas válidas: `Sum`  | 
| DataWriteOperations |  O número de operações de gravação para clientes que acessam o sistema de arquivos. Unidades: contagem Estatísticas válidas: `Sum`  | 
| MetadataOperations |  O número de operações de metadados para clientes que acessam o sistema de arquivos. Unidades: contagem Estatísticas válidas: `Sum`  | 
| ClientConnections | O número de conexões ativas entre clientes e o servidor de arquivos. Unidades: contagem | 

### Métricas do servidor de arquivos
<a name="fsx-file-server-metrics"></a>

O namespace do `AWS/FSx` inclui as seguintes métricas de servidor de arquivos.


| Métrica | Descrição | 
| --- | --- | 
| NetworkThroughputUtilization | O throughput da rede para clientes que acessam o sistema de arquivos, como uma porcentagem do limite provisionado. Unidades: percentual | 
| CPUUtilization | A porcentagem de utilização dos recursos de CPU do seu servidor de arquivos. Unidades: percentual | 
| MemoryUtilization | A porcentagem de utilização dos recursos de memória do seu servidor de arquivos. Unidades: percentual | 
| FileServerDiskThroughputUtilization | O throughput de disco entre o servidor de arquivos e seus volumes de armazenamento, como uma porcentagem do limite provisionado determinado pela capacidade de throughput. Unidades: percentual | 
| FileServerDiskThroughputBalance | A porcentagem de créditos de intermitência disponíveis para o throughput de disco entre o servidor de arquivos e seus volumes de armazenamento. Válido para sistemas de arquivos provisionados com capacidade de throughput de 256 MBps ou menos. Unidades: percentual | 
| FileServerDiskIopsUtilization | A IOPS de disco entre o servidor de arquivos e os volumes de armazenamento, como uma porcentagem do limite provisionado determinado pela capacidade de throughput. Unidades: percentual | 
| FileServerDiskIopsBalance | A porcentagem de créditos de intermitência disponíveis para a IOPS de disco entre o servidor de arquivos e seus volumes de armazenamento. Válido para sistemas de arquivos provisionados com capacidade de throughput de 256 MBps ou menos. Unidades: percentual | 

### Métricas de E/S de disco
<a name="fsx-diskio-metrics"></a>

O namespace do `AWS/FSx` inclui as seguintes métricas de E/S de disco:


| Métrica | Descrição | 
| --- | --- | 
| DiskReadBytes | O número de bytes para operações de leitura que acessam volumes de armazenamento. Unidades: bytes Estatística válida: soma  | 
| DiskWriteBytes | O número de bytes para operações de gravação que acessam volumes de armazenamento. Unidades: bytes Estatística válida: soma  | 
| DiskReadOperations |  O número de operações de leitura do servidor de arquivos que acessa os volumes de armazenamento. Unidades: contagem Estatísticas válidas: `Sum`  | 
| DiskWriteOperations |  O número de operações de gravação do servidor de arquivos que acessa os volumes de armazenamento. Unidades: contagem Estatísticas válidas: `Sum`  | 

### Métricas de volume de armazenamento do FSx para Windows
<a name="fsx-storage-volume-metrics"></a>

O namespace do `AWS/FSx` inclui as seguintes métricas de volume de armazenamento.


| Métrica | Descrição | 
| --- | --- | 
| DiskThroughputUtilization | (Somente HDD) O throughput de disco entre o servidor de arquivos e seus volumes de armazenamento, como uma porcentagem do limite provisionado determinado pelos volumes de armazenamento. Unidades: percentual | 
| DiskThroughputBalance | (Somente HDD) A porcentagem de créditos de intermitência disponíveis para o throughput de disco e as IOPS de disco para os volumes de armazenamento. Unidades: percentual | 
| DiskIopsUtilization | (Somente SSD) A IOPS de disco entre o servidor de arquivos e os volumes de armazenamento, como uma porcentagem do limite de IOPS provisionadas determinado pelos volumes de armazenamento. Unidades: percentual | 

### Métricas da capacidade de armazenamento
<a name="fsx-storage-capacity-metrics"></a>

O namespace `AWS/FSx` inclui as seguintes métricas de capacidade de armazenamento.


| Métrica | Descrição | 
| --- | --- | 
| FreeStorageCapacity |  A quantidade de capacidade de armazenamento disponível. Unidades: bytes Estatísticas válidas: `Average`, `Minimum`  | 
| StorageCapacityUtilization | Capacidade de armazenamento físico usada como porcentagem da capacidade total de armazenamento. Unidades: percentual | 
| DeduplicationSavedStorage | A quantidade de espaço de armazenamento economizada pela eliminação de duplicação dos dados, se ela estiver desabilitada. Unidades: bytes | 

### Namespace e dimensões para métricas do FSx para Windows File Server
<a name="fsx-dimensions"></a>

As métricas do FSx para Windows File Server usam o namespace do `FSx` e fornecem métricas para uma única dimensão, `FileSystemId`. Você pode encontrar o ID de um sistema de arquivos usando o comando da CLI AWS CLI [describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) ou o comando da API [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html). O ID do sistema de arquivos possui o formato de *fs-0123456789abcdef0*.

## Usar métricas do sistema de arquivos
<a name="how_to_use_metrics"></a>

Há dois componentes arquitetônicos principais de cada sistema de arquivos do Amazon FSx:
+ O **servidor de arquivos** que fornece dados aos clientes que acessam o sistema de arquivos.
+ Os **volumes de armazenamento** que hospedam os dados em seu sistema de arquivos.

O FSx para Windows File Server relata métricas no CloudWatch que rastreiam a performance e a utilização de recursos do servidor de arquivos e dos volumes de armazenamento do seu sistema de arquivos. O diagrama a seguir ilustra um sistema de arquivos do Amazon FSx com seus componentes arquitetônicos e as métricas de performance e recursos do CloudWatch disponíveis para monitoramento. A propriedade principal mostrada para um conjunto de métricas é a propriedade do sistema de arquivos que determina a capacidade para essas métricas. O ajuste dessa propriedade modifica a performance do sistema de arquivos para esse conjunto de métricas.

![\[O FSx para Windows File Server relata métricas no CloudWatch que monitoram a E/S de rede, a performance do servidor de arquivos e a performance do volume de armazenamento.\]](http://docs.aws.amazon.com/pt_br/fsx/latest/WindowsGuide/images/file-server-metrics-FSxW.png)


Use o painel **Monitoramento e performance** no console do Amazon FSx para visualizar asmétricas do FSx para Windows File Server CloudWatch descritas na tabela a seguir.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/fsx/latest/WindowsGuide/monitoring-cloudwatch.html)

**nota**  
1Recomendamos que você mantenha uma utilização média da capacidade de throughput abaixo de 50% para garantir que tenha capacidade de throughput sobressalente suficiente para picos inesperados em sua workload, bem como para quaisquer operações de armazenamento do Windows em segundo plano (como sincronização de armazenamento, eliminação de duplicação ou cópias de sombra).  
2Volumes de armazenamento em HDD podem sofrer variações significativas de desempenho, dependendo da workload. Picos repentinos nas IOPS ou no throughput podem levar à degradação do desempenho do disco. Para obter mais informações, consulte [Desempenho da expansão do HDD](performance.md#hdd-burst-performance).

## Avisos e recomendações de performance
<a name="performance-insights-FSxW"></a>

O FSx para Windows fornece avisos de performance para sistemas de arquivos configurados com uma capacidade de throughput de pelo menos 32 MBps. O Amazon FSx exibe um aviso para um conjunto de métricas do CloudWatch sempre que uma dessas métricas se aproxima ou ultrapassa um limite predeterminado para vários pontos de dados consecutivos. Esses avisos fornecem recomendações práticas que você pode usar para otimizar a performance do seu sistema de arquivos.

Os avisos podem ser acessados em várias áreas do painel **Monitoramento e performance**. Todos os avisos de performance ativos ou recentes do Amazon FSx e todos os alarmes do CloudWatch configurados para o sistema de arquivos que estão em um estado de ALARME aparecem no painel **Monitoramento e performance** na seção **Resumo**. O aviso também aparece na seção do painel em que o gráfico de métricas é exibido.

Você pode criar alarmes do CloudWatch para qualquer uma das métricas do Amazon FSx. Para obter mais informações, consulte [Criar alarmes do CloudWatch](creating_alarms.md).

### Use os avisos de performance para melhorar a performance do sistema de arquivos
<a name="resolve-warnings"></a>

O Amazon FSx fornece recomendações práticas que você pode usar para otimizar a performance do seu sistema de arquivos. Essas recomendações descrevem como lidar com um possível gargalo na performance. Você pode realizar a ação recomendada caso espere que a atividade continue ou se ela estiver causando um impacto na performance do seu sistema de arquivos. Dependendo da métrica que acionou um aviso, você pode resolvê-lo aumentando a capacidade de throughput ou a capacidade de armazenamento do sistema de arquivos, conforme descrito na tabela a seguir.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/fsx/latest/WindowsGuide/monitoring-cloudwatch.html)

**nota**  
Certos eventos do sistema de arquivos podem consumir recursos de performance de E/S de disco e potencialmente acionar avisos de performance. Por exemplo:  
A fase de otimização do dimensionamento da capacidade de armazenamento pode gerar maior throughput de disco, conforme descrito em [Aumentos da capacidade de armazenamento e performance do sistema de arquivos](managing-storage-configuration.md#storage-capacity-increase-and-performance)
Para sistemas de arquivos multi-AZ, eventos como o escalonamento da capacidade de throughput, a substituição de hardware ou a interrupção da zona de disponibilidade resultam em eventos automáticos de failover e failback. Todas as alterações de dados que ocorrerem durante esse período precisam ser sincronizadas entre os servidores de arquivos primário e secundário, e o Windows Server executa um trabalho de sincronização de dados que pode consumir recursos de E/S do disco. Para obter mais informações, consulte [Como gerenciar a capacidade de throughput](managing-throughput-capacity.md).

Para obter mais informações sobre a performance do sistema de arquivos, consulte [FSx para desempenho do Windows File Serverdesempenho](performance.md).

# Acesso a métricas de sistema de arquivos
<a name="accessingmetrics"></a>

Você pode visualizar as métricas do Amazon FSx para o CloudWatch das seguintes maneiras:
+ O console do Amazon FSx
+ O console do CloudWatch
+ A CLI do CloudWatch
+ A API do CloudWatch

Os procedimentos a seguir descrevem como acessar as métricas do seu sistema de arquivos usando essas várias ferramentas.

**Visualizar as métricas do sistema de arquivos usando o console do Amazon FSx**

1. Abra o console do Amazon FSx em [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/).

1. Para exibir a página de **Detalhes do sistema de arquivos**, selecione **Sistemas de arquivos** no painel de navegação.

1. Escolha o sistema de arquivos cujas métricas você deseja visualizar.

1. Para exibir gráficos das métricas do sistema de arquivos, escolha **Monitoramento e performance** no segundo painel.  
![\[Imagem da captura de tela do painel Monitoramento e performance no console do Amazon FSx.\]](http://docs.aws.amazon.com/pt_br/fsx/latest/WindowsGuide/images/FSxW-monitor-perf-panel.png)
   + As métricas de **Resumo** são exibidas por padrão, mostrando todos os avisos ativos e alarmes do CloudWatch, juntamente com as métricas de **Atividade do sistema de arquivos**.
   + Escolha **Armazenamento** para visualizar a capacidade de armazenamento e as métricas de utilização.
   + Selecione **Performance** para visualizar as métricas de performance do servidor de arquivos e do armazenamento.
   + Selecione **Alarmes do CloudWatch** para visualizar gráficos de todos os alarmes configurados para o sistema de arquivos.

   Para obter mais informações, consulte . [Usar métricas do sistema de arquivos](monitoring-cloudwatch.md#how_to_use_metrics)

**Para exibir métricas no console do CloudWatch**

1. Para visualizar uma métrica de sistema de arquivos na página **Métricas** do console do Amazon CloudWatch, navegue até a métrica no painel **Monitoramento e performance** do console do Amazon FSx.

1. Selecione **Visualizar em métricas** no menu de ações no canto superior direito do gráfico de métricas, conforme mostrado na imagem a seguir.  
![\[Imagem do gráfico da métrica Total de IOPS, com o menu de ações do gráfico exibido para mostrar a ação Visualizar em métricas.\]](http://docs.aws.amazon.com/pt_br/fsx/latest/WindowsGuide/images/view-metric-in-CW-fsxW.png)

   Isso abre a página **Métricas** no console do CloudWatch, mostrando o gráfico de métricas, conforme mostrado na imagem a seguir.  
![\[Imagem do gráfico da métrica Total de IOPS mostrado no console do CloudWatch.\]](http://docs.aws.amazon.com/pt_br/fsx/latest/WindowsGuide/images/metric-in-CW-console.png)

**Adicionar métricas a um painel do CloudWatch**

1. Para adicionar um conjunto de métricas do sistema de arquivos do FSx para Windows a um painel no console do CloudWatch, escolha o conjunto de métricas (**Resumo**, **Armazenamento** ou **Desempenho**) no painel **Monitoramento e desempenho** do console do Amazon FSx.

1. Selecione **Adicionar ao painel** no canto superior direito do painel, o que abre o console do CloudWatch.

1. Selecione um painel existente do CloudWatch na lista ou crie um novo. Para obter mais informações, consulte [Utilizar painéis do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) no *Manual do usuário do Amazon CloudWatch*.

**Para acessar as métricas a partir da AWS CLI**
+ Use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) com o namespace `--namespace "AWS/FSx"`. Para obter mais informações, consulte a [Referência de comandos da AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/).

  ```
  $ aws cloudwatch list-metrics --namespace "AWS/FSx"
  aws cloudwatch list-metrics --namespace "AWS/FSx"
  {
      "Metrics": [
          {
              "Namespace": "AWS/FSx",
              "MetricName": "DataWriteOperationTime",
              "Dimensions": [
                  {
                      "Name": "FileSystemId",
                      "Value": "fs-09a106ebc3a0bb087"
                  }
              ]
          },
          {
              "Namespace": "AWS/FSx",
              "MetricName": "CapacityPoolWriteBytes",
              "Dimensions": [
                  {
                      "Name": "VolumeId",
                      "Value": "fsvol-0cb2281509f5db3c2"
                  },
                  {
                      "Name": "FileSystemId",
                      "Value": "fs-09a106ebc3a0bb087"
                  }
              ]
          },
          {
              "Namespace": "AWS/FSx",
              "MetricName": "DiskReadBytes",
              "Dimensions": [
                  {
                      "Name": "FileSystemId",
                      "Value": "fs-09a106ebc3a0bb087"
                  }
              ]
          },
          {
              "Namespace": "AWS/FSx",
              "MetricName": "CompressionRatio",
              "Dimensions": [
                  {
                      "Name": "FileSystemId",
                      "Value": "fs-0f84c9a176a4d7c92"
                  }
              ]
          },
  .
  .
  .
  }
  ```

**Como usar a API do CloudWatch**

**Acessar as métricas com a API do CloudWatch**
+ Chame `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Para obter mais informações, consulte a [Referência da API do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/). 

# Criar alarmes do CloudWatch
<a name="creating_alarms"></a>

Você pode criar um alarme do CloudWatch que envia uma mensagem do Amazon SNS quando o alarme muda de estado. Um alarme observa uma única métrica ao longo de um período especificado por você e realiza uma ou mais ações com base no valor da métrica relativo a um determinado limite ao longo de vários períodos. A ação é uma notificação enviada para um tópico do Amazon SNS ou uma política de Auto Scaling.

Os alertas invocam ações apenas para alterações de estado mantidas. Os alarmes do CloudWatch não invocam ações simplesmente por estarem em um estado específico. O estado deve ter sofrido alteração e deve ter sido mantido por um determinado número de períodos. É possível criar um alarme no console do Amazon FSx ou no console do CloudWatch.

Os procedimentos a seguir descrevem como criar alarmes para o Amazon FSx usando o console, a AWS CLI, e a API.

**Para definir um alarme do CloudWatch (console)**

1. Abra o console do Amazon FSx em [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/).

1. No painel de navegação, selecione **Sistemas de arquivos** e, em seguida, selecione o sistema de arquivos para o qual você deseja criar o alarme.

1. Selecione o menu **Ações** e selecione **Visualizar detalhes**. 

1. Na página **Resumo**, selecione **Monitoramento e performance**. 

1. Selecione os **alarmes do CloudWatch**. 

1. Escolha **Criar alarme do CloudWatch**. O sistema redireciona você para o console do CloudWatch.

1. Selecione **Selecionar métricas** e, em seguida, **Próximo**.

1. Na seção **Métricas**, escolha **FSx**.

1. Selecione **Métricas do sistema de arquivos**, selecione a métrica para a qual deseja definir o alarme e, em seguida, escolha **Selecionar métrica**.

1. Na seção **Condições**, escolha as condições desejadas para o alarme e clique em **Próximo**.
**nota**  
As métricas não podem ser publicadas durante a manutenção do sistema de arquivos para sistemas de arquivos single-AZ, ou durante o failover e o failback de ou para os servidores primários ou secundários para sistemas de arquivos multi-AZ. Para evitar alterações desnecessárias e equivocadas nas condições de alarmes e configurar os alarmes para que sejam resilientes a pontos de dados ausentes, consulte [Configurar como os alarmes do CloudWatch tratam dados ausentes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data) no *Guia do usuário do Amazon CloudWatch*.

1. Se quiser que o CloudWatch envie a você uma notificação por e-mail ou SNS quando o estado de alarme acionar a ação, selecione um estado de alarme para **Sempre que esse estado de alarme ocorrer**. 

   Para **selecionar um tópico do SNS**, escolha um tópico existente do SNS. Se você selecionar **Create topic**, poderá definir o nome e o endereço de e-mail para uma nova lista de assinatura de e-mail. Essa lista é salva e aparece no campo para alarmes futuros. Escolha **Próximo**.
**nota**  
Se você usar **Create topic (Criar tópico)** para criar um novo tópico do Amazon SNS, os endereços de e-mail deverão ser verificados antes que eles recebam notificações. Os e-mails são enviados apenas quando o alarme entra em um status de alarme. Se essa alteração no status de alarme ocorrer antes dos endereços de e-mail serem verificados, eles não receberão notificação.

1. Preencha os valores **Nome**, **Descrição** e **Sempre** para a métrica e selecione **Próximo**. 

1. Na página **Pré-visualizar e criar**, revise o alarme que você está prestes a criar e, em seguida, selecione **Criar alarme**. 

**Para definir alertas usando o console do CloudWatch**

1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Escolha **Criar alarme** para iniciar o **Assistente de criação de alarmes**. 

1. Selecione **Métricas do FSx** e percorra as métricas do Amazon FSx para localizar a métrica na qual você deseja colocar um alarme. Para exibir apenas as métricas do Amazon FSx nessa caixa de diálogo, pesquise o ID do sistema de arquivos do seu sistema de arquivos. Selecione a métrica para criar um alarme e selecione **Próximo**.

1.  Preencha os valores de **Name**, **Description** e **Whenever** para a métrica. 

1. Se você quiser que o CloudWatch envie um e-mail quando o estado do alarme for atingido, em **Sempre que este alarme**, escolha **Estado ALARM**. Em **Enviar notificação para**, escolha um tópico do SNS existente. Se você selecionar **Create topic**, poderá definir o nome e o endereço de e-mail para uma nova lista de assinatura de e-mail. Essa lista é salva e aparece no campo para alarmes futuros.
**nota**  
Se você usar **Create topic (Criar tópico)** para criar um novo tópico do Amazon SNS, os endereços de e-mail deverão ser verificados antes que eles recebam notificações. Os e-mails são enviados apenas quando o alarme entra em um status de alarme. Se essa alteração no status de alarme ocorrer antes dos endereços de e-mail serem verificados, eles não receberão notificação.

1. Neste ponto, a área de **Visualização do alarme** oferece a chance de visualizar o alarme que será criado. Escolha **Criar Alarm**. 

**Para definir um alarme do CloudWatch (CLI)**
+ Chame `[put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/put-metric-alarm.html)`. Para obter mais informações, consulte *Referência de comandos da [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/)*.

**Para definir um alarme (API)**
+ Chame `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Para obter mais informações, consulte a *[referência de APIs do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*. 

# Registrar em log as chamadas de API do Amazon FSx para Windows File Server usando o AWS CloudTrail
<a name="logging-using-cloudtrail"></a>

O Amazon FSx para Windows File Server está integrado ao AWS CloudTrail, um serviço que fornece um registro das ações executadas por um usuário, um perfil ou um serviço da AWS no Amazon FSx. O CloudTrail captura todas as chamadas de API do Amazon FSx como eventos. As chamadas capturadas incluem as chamadas do console do Amazon FSx e as chamadas de código para as operações de API do Amazon FSx. Caso crie uma trilha, você poderá habilitar a entrega contínua de eventos do CloudTrail para um bucket do Amazon S3, incluindo eventos do Amazon FSx. Se você não configurar uma trilha, ainda poderá visualizar os eventos mais recentes no console do CloudTrail em **Histórico de eventos**. Usando as informações coletadas pelo CloudTrail, é possível determinar a solicitação feita ao Amazon FSx, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e outros detalhes.

Para saber mais sobre o CloudTrail, consulte o [Guia do usuário do AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).

## Informações sobre o Amazon FSx no CloudTrail
<a name="service-name-info-in-cloudtrail"></a>

O CloudTrail é habilitado em sua Conta da AWS quando ela é criada. Quando ocorre uma atividade no Amazon FSx, esta atividade é registrada em um evento do CloudTrail com outros eventos de serviço da AWS no **Histórico de eventos**. Você pode visualizar, pesquisar e baixar eventos recentes em sua Conta da AWS. Para obter mais informações, consulte [Como visualizar eventos com o histórico de eventos do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).

Para obter um registro de eventos em andamento na sua Conta da AWS, incluindo eventos do Amazon FSx, crie uma trilha. Uma *trilha* permite que o CloudTrail entregue arquivos de log a um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as Regiões da AWS. A trilha registra eventos de todas as regiões na partição da AWS e entrega os arquivos de log no bucket do Amazon S3 que você especifica. Além disso, é possível configurar outros AWS serviços para melhor analisar e agir de acordo com dados coletados do evento nos logs CloudTrail. Para obter mais informações, consulte:
+ [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [Serviços e integrações compatíveis com o CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Configuração notificações do Amazon SNS para o CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Receber arquivos de log do CloudTrail de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [Receber arquivos de log do CloudTrail de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

Todas as ações do Amazon FSx são registradas em log pelo CloudTrail e documentadas na [Amazon FSx API Reference](https://docs.aws.amazon.com/fsx/latest/APIReference/Welcome.html). Por exemplo, as chamadas às ações `CreateFileSystem`, `CreateBackup` e `TagResource` geram entradas nos arquivos de log do CloudTrail.

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar:
+ Se a solicitação foi feita com credenciais de usuário-raiz ou usuário do AWS Identity and Access Management (IAM).
+ Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado.
+ Se a solicitação foi feita por outro AWS serviço.

Para obter mais informações, consulte [Elemento userIdentity do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Noções básicas sobre entradas de arquivos de log do Amazon FSx
<a name="understanding-service-name-entries"></a>

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log a um bucket Amazon S3 especificado. Os arquivos de log CloudTrail contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte, e inclui informações sobre a ação solicitada, data e hora da ação, parâmetros da solicitação e assim por diante. Os arquivos de log do CloudTrail não são um rastreamento de pilha ordenada de chamadas de API pública, portanto, não são exibidos em uma ordem específica. 

O exemplo a seguir mostra uma entrada de log do CloudTrail que demonstra a operação `TagResource` quando uma tag para um sistema de arquivos é criada no console.

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": “Root”,
        "principalId": “111122223333”,
        "arn": "arn:aws:sts::111122223333:root”,
        "accountId": “111122223333”,
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE”,
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2018-11-14T22:36:07Z"
            }
        }
    },
    "eventTime": "2018-11-14T22:36:07Z",
    "eventSource": "fsx.amazonaws.com",
    "eventName": "TagResource",
    "awsRegion": "us-east-1",
    "sourceIPAddress": “192.0.2.0”,
    "userAgent": “console.amazonaws.com”,
    "requestParameters": {
        "resourceARN": "arn:aws:fsx:us-east-1:111122223333:file-system/fs-ab12cd34ef56gh789”
    },
    "responseElements": null,
    "requestID": “aEXAMPLE-abcd-1234-56ef-b4cEXAMPLE51”,
    "eventID": “bEXAMPLE-gl12-3f5h-3sh4-ab6EXAMPLE9p”,
    "eventType": "AwsApiCall",
    "apiVersion": "2018-03-01",
    "recipientAccountId": “111122223333”
}
```

O exemplo a seguir mostra uma entrada de log do CloudTrail que demonstra a ação `UntagResource` quando uma tag para um sistema de arquivos é excluída do console.

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": “Root”,
        "principalId": "111122223333",
        "arn": "arn:aws:sts::111122223333:root",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2018-11-14T23:40:54Z"
            }
        }
    },
    "eventTime": "2018-11-14T23:40:54Z",
    "eventSource": "fsx.amazonaws.com",
    "eventName": "UntagResource",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "192.0.2.0",
    "userAgent": "console.amazonaws.com",
    "requestParameters": {
        "resourceARN": "arn:aws:fsx:us-east-1:111122223333:file-system/fs-ab12cd34ef56gh789"
    },
    "responseElements": null,
    "requestID": "aEXAMPLE-abcd-1234-56ef-b4cEXAMPLE51",
    "eventID": "bEXAMPLE-gl12-3f5h-3sh4-ab6EXAMPLE9p",
    "eventType": "AwsApiCall",
    "apiVersion": "2018-03-01",
    "recipientAccountId": "111122223333"
}
```