

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 ONTAP usando Harvest e Grafana
<a name="monitoring-harvest-grafana"></a>

NetApp O Harvest é uma ferramenta de código aberto para coletar métricas de desempenho e capacidade dos sistemas ONTAP e é compatível com o FSx for ONTAP. Você pode usar o Harvest com Grafana para uma solução de monitoramento de código aberto.

## Conceitos básicos do Harvest e Grafana
<a name="harvest-grafana"></a>

A seção a seguir detalha como você pode instalar e configurar o Harvest e o Grafana para medir o desempenho e a utilização da capacidade de armazenamento do sistema de arquivos do seu FSx para ONTAP. 

Você pode monitorar seu sistema de arquivos Amazon FSx for NetApp ONTAP usando e. Harvest Grafana NetApp Harvestmonitora data ONTAP centers coletando métricas de desempenho, capacidade e hardware do FSx para sistemas de arquivos ONTAP. Grafanafornece um painel onde as Harvest métricas coletadas podem ser exibidas.

## Painéis compatíveis do Harvest
<a name="supported-harvest-dashboards"></a>

O Amazon FSx for NetApp ONTAP expõe um conjunto de métricas diferente do que o local. NetApp ONTAP Portanto, apenas os painéis abaixo prontos para uso do Harvest, marcados com `fsx`, são atualmente compatíveis para uso no FSx para ONTAP. Alguns desses painéis podem não apresentar as informações que não são compatíveis.
+ Harvest: metadados
+ ONTAP: agregado
+ ONTAP: cDOT
+ ONTAP: cluster
+ ONTAP: conformidade
+ ONTAP: data center
+ ONTAP: proteção de dados
+ PONTO DE CONTATO: LUN
+ ONTAP: rede
+ ONTAP: Node
+ ONTAP: Qtree
+ ONTAP: segurança
+ TOQUE EM: SnapMirror
+ ONTAP: Destinos SnapMirror 
+ ONTAP: Fontes SnapMirror 
+ ONTAP: SVM
+ ONTAP: volume
+ ONTAP: volume por SVM
+ ONTAP: análise aprofundada do volume

Os Harvest painéis a seguir são compatíveis com o FSx para ONTAP, mas não estão habilitados por padrão no. Harvest
+ TOQUE EM: FlexCache
+ TOQUE EM: FlexGroup
+ ONTAP: Clientes NFS
+ ONTAP: monitores do Storepool NFSv4
+ ONTAP: solução de problemas de NFS
+ ONTAP: namespaces NVMe
+ ONTAP: SMB
+ ONTAP: workload

## Sem suporte Colheita painéis
<a name="unsupported-dashboards"></a>

Os Harvest painéis a seguir *não* são compatíveis com o FSx para ONTAP.
+ ONTAP: disco
+ ONTAP: Operação de serviço externo
+ ONTAP: Análise de sistemas de arquivos (FSA)
+ ONTAP: espaço
+ ONTAP: saúde
+ ONTAP: solicitação de ONTAP: solicitação
+ TOQUE EM: MetroCluster
+ ONTAP: potência
+ ONTAP: prateleira
+ ONTAP: Armazenamentos de objetos do S3

## CloudFormation modelo
<a name="harvest-grafana-template"></a>

Para começar, você pode implantar um CloudFormation modelo que inicia automaticamente uma instância do Amazon EC2 executando Harvest e Grafana. Como entrada para o CloudFormation modelo, você especifica o `fsxadmin` usuário e o endpoint de gerenciamento do Amazon FSx para o sistema de arquivos que será adicionado como parte dessa implantação. Depois que a implantação for concluída, você poderá fazer login no painel do Grafana para monitorar seu sistema de arquivos.

Essa solução é usada CloudFormation para automatizar a implantação da solução Harvest e Grafana. O modelo cria uma instância do Linux do Amazon EC2 e instala os softwares Harvest e Grafana. Para usar essa solução, baixe o modelo [CloudFormation fsx-ontap-harvest-grafana.template](https://solution-references.s3.amazonaws.com/fsx/harvest-grafana/harvest-grafana.yaml).

**nota**  
A implementação dessa solução gera cobrança pelos serviços associados AWS . Para obter mais informações, consulte as páginas de detalhes de preços desses serviços.

## Tipos de instância do Amazon EC2
<a name="ec2-instance-types"></a>

Ao configurar o modelo, você fornece o tipo de instância do Amazon EC2. NetAppA recomendação da para o tamanho da instância depende de quantos sistemas de arquivos você monitora e do número de métricas que você escolhe coletar. Com a configuração padrão, para cada 10 sistemas de arquivos que você monitora, NetApp recomenda:
+ CPU: dois núcleos
+ Memória: 1 GB
+ Disco: 500 MB (usado principalmente por arquivos de log)

Veja a seguir alguns exemplos de configurações e o tipo de instância `t3` que você pode escolher.


****  

| Sistemas de arquivos | CPU | Disk | Tipo de instância | 
| --- | --- | --- | --- | 
| Menos de 10 | 2 núcleos | 500 MB | `t3.micro` | 
| De 10 a 40 | 4 núcleos | 1 mil MB | `t3.xlarge` | 
| 40\+ | 8 núcleos | 2 mil MB | `t3.2xlarge` | 

Para obter mais informações sobre os tipos de instância do Amazon EC2, consulte [Instâncias de uso geral](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/general-purpose-instances.html) no *Guia do usuário do Amazon EC2*.

### Regras de porta para instância
<a name="instance-port-rules"></a>

Ao configurar sua instância do Amazon EC2, certifique-se de que as portas 3000 e 9090 estejam abertas para tráfego de entrada do grupo de segurança em que as instâncias do Harvest e Grafana do Amazon EC2 estão. Como a instância que é iniciada se conecta a um endpoint via HTTPS, ela precisa resolver o endpoint, que precisa da porta 53 TCP/UDP para DNS. Além disso, para alcançar o endpoint, ele precisa da porta 443 TCP para HTTPS e acesso à Internet.

## Procedimento de implantação
<a name="harvest-grafana-deployment"></a>

O procedimento a seguir configura e implanta a Harvest/Grafana solução. A implantação demora cerca de cinco minutos. Antes de começar, você deve ter um sistema de arquivos FSx for ONTAP em execução em uma Amazon Virtual Private Cloud (Amazon VPC) em sua AWS conta e as informações de parâmetros do modelo listado abaixo. Para obter mais informações sobre como criar um sistema de arquivos, consulte [Criar sistemas de arquivos](creating-file-systems.md).

**Para iniciar a pilha de Harvest/Grafana soluções**

1. Baixe o modelo [CloudFormation fsx-ontap-harvest-grafana.template](https://solution-references.s3.amazonaws.com/fsx/harvest-grafana/harvest-grafana.yaml). Para obter mais informações sobre como criar uma CloudFormation pilha, consulte [Como criar uma pilha no AWS CloudFormation console no Guia](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) do *AWS CloudFormation usuário*.
**nota**  
Por padrão, esse modelo é iniciado na AWS região Leste dos EUA (Norte da Virgínia). Você deve iniciar essa solução em um Região da AWS local onde o Amazon FSx esteja disponível. Para obter mais informações, consulte [Amazon FSx endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/fsxn.html) na *Referência geral da AWS. *

1. Em **Parâmetros**, analise os parâmetros para o modelo e modifique-os de acordo com as necessidades do seu sistema de arquivos. Essa solução usa os valores padrão apresentados a seguir.  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/fsx/latest/ONTAPGuide/monitoring-harvest-grafana.html)

1. Escolha **Próximo**.

1. Em **Opções**, escolha **Próximo**.

1. Em **Análise**, analise e confirme as configurações. Você deve selecionar a caixa de seleção confirmando que o modelo cria os recursos do IAM.

1. Selecione **Criar** para implantar a stack.

Você pode ver o status da pilha no CloudFormation console na coluna **Status**. Você deverá visualizar um status **CREATE\_COMPLETE** em cerca de cinco minutos.

## Fazer login no Grafana
<a name="harvest-grafana-login"></a>

Após a conclusão da implantação, use seu navegador para fazer login no painel do Grafana no IP e na porta 3000 da instância do Amazon EC2:

```
http://{{EC2_instance_IP}}:3000
```

Quando solicitado, use o nome de usuário (`admin`) e a senha (`pass`) padrão do Grafana. Recomendamos que você altere sua senha assim que fizer login.

Para obter mais informações, consulte a página [ NetApp Harvest](https://github.com/NetApp/harvest) em GitHub.

## Solução de problemas do Harvest e Grafana
<a name="troubleshooting-harvest-grafana"></a>

Se você estiver encontrando dados ausentes mencionado nos painéis do Harvest e do Grafana ou estiver enfrentando problemas para configurar o Harvest e o Grafana com o FSx para ONTAP, consulte os tópicos a seguir para uma possível solução.

**Topics**
+ [Os painéis de SVM e volume estão em branco](#svm-volume-blank-dashboards)
+ [CloudFormation pilha revertida após o tempo limite](#cfn-stack-rolled-back)

### Os painéis de SVM e volume estão em branco
<a name="svm-volume-blank-dashboards"></a>

Se a CloudFormation pilha foi implantada com sucesso e puder entrar em contato com a Grafana, mas os painéis de SVM e volume estiverem em branco, use o procedimento a seguir para solucionar problemas em seu ambiente. Você precisará de acesso SSH à instância do Amazon EC2 na qual o Harvest e o Grafana estão implantados.

1. Faça o SSH na instância do Amazon EC2 na qual seus clientes do Harvest e Grafana estão sendo executados.

   ```
   [~]$ ssh ec2-user@{{ec2_ip_address}}
   ```

1. Use o seguinte comando para abrir o arquivo `harvest.yml` e:
   + Verifique se uma entrada foi criada para sua instância do FSx para ONTAP como `Cluster-2`.
   + Verifique se as entradas de nome de usuário e senha correspondem às suas credenciais de `fsxadmin`.

   ```
   [ec2-user@ip-{{ec2_ip_address}} ~]$ sudo cat /home/ec2-user/harvest_install/harvest/harvest.yml
   ```

1. Se o campo de senha estiver em branco, abra o arquivo em um editor e atualize-o com a senha de `fsxadmin` da seguinte forma:

   ```
   [ec2-user@ip-{{ec2_ip_address}} ~]$ sudo vi /home/ec2-user/harvest_install/harvest/harvest.yml
   ```

1. Certifique-se de que as credenciais de usuário de `fsxadmin` estejam armazenadas no Secrets Manager no formato a seguir para qualquer implantação futura, substituindo `{{fsxadmin_password}}` pela sua senha.

   ```
   {"username" : "fsxadmin", "password" : "{{fsxadmin_password}}"}
   ```

### CloudFormation pilha revertida após o tempo limite
<a name="cfn-stack-rolled-back"></a>

Se você não conseguir implantar a CloudFormation pilha com êxito e ela estiver sendo revertida com erros, use o procedimento a seguir para resolver o problema. Você precisará de acesso SSH à instância do EC2 implantada pela pilha. CloudFormation 

1. Reimplante a CloudFormation pilha, certificando-se de que a reversão automática esteja desativada.

1. Faça o SSH na instância do Amazon EC2 na qual seus clientes do Harvest e Grafana estão sendo executados.

   ```
   [~]$ ssh ec2-user@{{ec2_ip_address}}
   ```

1. Use o comando a seguir para verificar se os contêineres do docker foram iniciados com sucesso.

   ```
   [ec2-user@ip-{{ec2_ip_address}} ~]$ sudo docker ps
   ```

   Na resposta, você deverá ver cinco contêineres da seguinte forma:

   ```
   CONTAINER ID   IMAGE                   COMMAND                  CREATED         STATUS                          PORTS                    NAMES
   6b9b3f2085ef   rahulguptajss/harvest   "bin/poller --config…"   8 minutes ago   Restarting (1) 20 seconds ago                            harvest_cluster-2
   3cf3e3623fde   rahulguptajss/harvest   "bin/poller --config…"   8 minutes ago   Up About a minute                                        harvest_cluster-1
   708f3b7ef6f8   grafana/grafana         "/run.sh"                8 minutes ago   Up 8 minutes                    0.0.0.0:3000->3000/tcp   harvest_grafana
   0febee61cab7   prom/alertmanager       "/bin/alertmanager -…"   8 minutes ago   Up 8 minutes                    0.0.0.0:9093->9093/tcp   harvest_prometheus_alertmanager
   1706d8cd5a0c   prom/prometheus         "/bin/prometheus --c…"   8 minutes ago   Up 8 minutes                    0.0.0.0:9090->9090/tcp   harvest_prometheus
   ```

1. Se os contêineres do docker não estiverem em execução, verifique se há falhas no arquivo `/var/log/cloud-init-output.log` da seguinte maneira.

   ```
   [ec2-user@ip-{{ec2_ip_address}} ~]$ sudo cat /var/log/cloud-init-output.log
        PLAY [Manage Harvest] **********************************************************
    
   TASK [Gathering Facts] *********************************************************
   ok: [localhost]
    
   TASK [Verify images] ***********************************************************
   failed: [localhost] (item=prom/prometheus) => {"ansible_loop_var": "item", "changed": false, "item": "prom/prometheus",
   "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetError(104, 'Co
   nnection reset by peer'))"}
   failed: [localhost] (item=prom/alertmanager) => {"ansible_loop_var": "item", "changed": false, "item": "prom/alertmanage
   r", "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetError(104,
   'Connection reset by peer'))"}
   failed: [localhost] (item=rahulguptajss/harvest) => {"ansible_loop_var": "item", "changed": false, "item": "rahulguptajs
   s/harvest", "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetEr
   ror(104, 'Connection reset by peer'))"}
   failed: [localhost] (item=grafana/grafana) => {"ansible_loop_var": "item", "changed": false, "item": "grafana/grafana",
   "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetError(104, 'Co
   nnection reset by peer'))"}
    
   PLAY RECAP *********************************************************************
   localhost                  : ok=1    changed=0    unreachable=0    failed=1    skipped=0    rescued=0    ignored=0
   ```

1. Se houver falhas, execute os comandos a seguir para implantar os contêineres do Harvest e Grafana.

   ```
   [ec2-user@ip-{{ec2_ip_address}} ~]$ sudo su
        [ec2-user@ip-{{ec2_ip_address}} ~]$ cd /home/ec2-user/harvest_install
        [ec2-user@ip-{{ec2_ip_address}} ~]$ /usr/local/bin/ansible-playbook manage_harvest.yml
        [ec2-user@ip-{{ec2_ip_address}} ~]$ /usr/local/bin/ansible-playbook manage_harvest.yml --tags api
   ```

1. Valide os contêineres iniciados com sucesso executando **sudo docker ps** e conectando-se ao seu URL do Harvest e Grafana.