Monitoramento do Amazon DocumentDB
Instana monitora o Amazon DocumentDB e oferece visibilidade do seu ambiente por meio do sensor Amazon DocumentDB.
Após instalar o agente do Instana, o sensor do Amazon DocumentDB é automaticamente implantado e instalado. Você pode visualizar métricas relacionadas ao Amazon DocumentDB na interface do usuário do Instana.
O Amazon DocumentDB suporta clusters baseados em instâncias e clusters elásticos. O sensor Amazon DocumentDB monitora os dois tipos de clusters e instâncias de clusters baseados em instâncias.
Para clusters baseados em instâncias, o sensor Amazon DocumentDB é compatível com as seguintes versões de mecanismo:
- 5.0.0 (padrão)
- 4.0.0
- 3.6.0
Para obter mais informações sobre os outros serviços do AWS compatíveis, consulte a documentação do AWS.
Permissões requeridas
O sensor Amazon DocumentDB requer a seguinte permissão AWS Identity and Access Management (IAM) para coletar métricas do Amazon DocumentDB:
docdb-elastic:ListClustersdocdb-elastic:GetClusterdocdb-elastic:ListTagsForResourcerds:DescribeDBClustersrds:DescribeDBInstancesrds:ListTagsForResource
Configurando o sensor do Amazon DocumentDB
Após instalar o agente de host do Instana, o Instana é configurado automaticamente para monitorar clusters e instâncias do Amazon DocumentDB por padrão.
As métricas do Amazon DocumentDB são coletadas a cada minuto; você pode alterar essa frequência usando a seguinte configuração no arquivo de configuração do agente <agent_install_dir>/etc/instana/configuration.yamlInstana :
com.instana.plugin.aws.documentdb:
cloudwatch_period: 300
Desativar o sensor
Para desativar o monitoramento de clusters e instâncias de DocumentDB, use a seguinte configuração:
com.instana.plugin.aws.documentdb:
enabled: false
Ativando a configuração do proxy
Para ativar o sensor Amazon DocumentDB para usar a configuração de proxy, adicione as seguintes definições de configuração do agente:
com.instana.plugin.aws.documentdb:
proxy_host: 'example.com' # proxy host name or ip address
proxy_port: 3128 # proxy port
proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
proxy_username: 'username' # OPTIONAL: proxy username
proxy_password: 'password' # OPTIONAL: proxy password
Monitorando diversas contas da AWS
Para configurar o monitoramento de várias AWS com um AWS na mesma região, você pode usar duas abordagens. Para obter mais informações, consulte Monitoramento de várias contas do AWS.
Abordagem de perfis nomeados da AWS
Na abordagem de perfis nomeados do AWS, você pode definir o perfil. Para substituir os perfis que são usados para monitorar o DocumentDB, use a seguinte configuração no arquivo de configuração do agente:
com.instana.plugin.aws.documentdb:
profile_names:
- 'profile2'
- 'profile3'
AWS Abordagem do Serviço de Tokens de Segurança (STS)
Para substituir as funções de IAM usadas para monitorar o Amazon DocumentDB, use a seguinte configuração no arquivo de configuração do agente:
com.instana.plugin.aws.documentdb:
role_arns:
- 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
- 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
Filtrar serviços por tags
Instana monitora todos os serviços do Amazon DocumentDB por padrão. Você pode definir quais serviços deseja monitorar definindo várias tags, separadas por vírgula. Você deve fornecer as tags como um par de valores-chave separados por dois pontos (:) no arquivo configuration.yaml. Para configurar facilmente o sensor Amazon DocumentDB, você pode definir as tags que deseja incluir ou excluir da detecção. Se as tags forem definidas em ambas as listas (incluir e excluir), a lista de exclusão terá prioridade mais alta. Se a filtragem por nível de serviço não for necessária, não é preciso definir a configuração para o ` DocumentDB `, pois a configuração é feita no nível de configuração ` AWS `.
Você pode especificar o intervalo do sensor (padrão 60 segundos) para pesquisar os recursos marcados com AWS usando a propriedade de configuração tagged-services-poll-rate.
Para definir o intervalo dos sensores para sondar os recursos marcados com AWS, use a seguinte configuração:
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 60
Para incluir serviços por tags na descoberta, atualize a seguinte configuração:
com.instana.plugin.aws.documentdb:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
Para excluir os serviços por tags da descoberta, atualize a seguinte configuração:
com.instana.plugin.aws.documentdb:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
Os serviços AWS sem tags são monitorados por padrão, mas você pode excluí-los definindo o campo include_untagged como false, conforme mostrado no exemplo a seguir:
com.instana.plugin.aws.documentdb:
include_untagged: false # True value by default
Tags do agente Instana
Instana As tags de agente estão disponíveis apenas com o Agente do AWS. Para obter mais informações sobre como usar as tags de agente, consulte Monitoramento da infraestrutura.
Visualizando as métricas
Para visualizar as métricas, conclua as etapas a seguir:
- No menu de navegação da interface do usuário do Instana, selecione Infraestrutura.
- Clique em uma instância monitorada específica do Amazon DocumentDB. Você pode ver o painel da instância do Amazon DocumentDB com todas as métricas coletadas.
- Na barra de rolagem no canto superior esquerdo do painel, selecione o cluster associado à instância. Você pode ver as métricas do cluster.
DocumentDB Cluster baseado em instâncias
As seções a seguir mostram os dados de configuração e as métricas coletadas para os clusters baseados em instância do DocumentDB.
Dados de configuração
A tabela a seguir descreve os dados de configuração coletados para o cluster baseado em instância do Amazon DocumentDB:
| DocumentDB detalhes do cluster | Descrição |
|---|---|
| ARN | O Amazon Resource Name (ARN) do cluster baseado em instância do DocumentDB. |
| Tipo de cluster | O tipo de cluster (baseado em instância ou elástico). |
| Horário de criação do cluster | A hora em que o cluster é criado. |
| Nome | O nome do cluster. |
| Versão do Mecanismo | A versão do motor do cluster. O valor é 5.0.0 (padrão), 4.0.0 ou 3.6.0. |
Métrica
A tabela a seguir descreve os detalhes das métricas do cluster baseado em instância do Amazon DocumentDB:
| Métricas de cluster | Descrição |
|---|---|
| Utilização da CPU | A porcentagem de uso da CPU. Para clusters, essa métrica representa uma agregação dos valores de uso da CPU de todas as instâncias. |
| DatabaseConnections | O número de conexões que estão abertas em um cluster, que são coletadas com uma frequência de um minuto. |
| Volume ReadIOPs | O número médio de operações de E/S de leitura faturadas de um volume de cluster, que são relatadas em intervalos de 5 minutos. |
| Volume WriteIOPs | O número médio de operações de E/S de gravação faturadas de um volume de cluster, que são relatadas em intervalos de 5 minutos. |
| Documentos excluídos | O número de documentos que são excluídos em um período de um minuto. |
| Documentos inseridos | O número de documentos que são inseridos em um período de um minuto. |
| Documentos atualizados | O número de documentos que são atualizados em um período de um minuto. |
| Documentos devolvidos | O número de documentos que são retornados em um período de um minuto. |
| Rendimento de leitura | O número médio de bytes que são lidos do disco por segundo. |
| Rendimento de gravação | O número médio de bytes gravados no disco por segundo. |
| Transações abertas | O número de transações que estão abertas em um cluster em um minuto. |
| Máximo de transações abertas | O número máximo de transações que são abertas em um cluster em um minuto. |
| Transações abertas usadas | Transações em aberto ÷ Transações em aberto máximo * 100. |
| Latência de leitura | O tempo médio necessário para operações de E/S de leitura de disco. |
| Latência de gravação | O tempo médio (em milissegundos) gasto por operação de E/S de disco. |
| DBCluster ReplicaLag Máximo | A quantidade máxima de atraso (em milissegundos) entre a instância primária e cada instância do Amazon DocumentDB no cluster. |
| DBCluster ReplicaLag Mínimo | A quantidade mínima de atraso (em milissegundos) entre a instância primária e cada instância de réplica no cluster. |
| Transações iniciadas | O número de transações que são iniciadas em um minuto. |
| Transações interrompidas | O número de transações que são abortadas em um minuto. |
| Transações confirmadas | O número de transações confirmadas em um minuto. |
DocumentDB instância
O sensor Amazon DocumentDB coleta os seguintes dados da instância Amazon DocumentDB:
Dados de configuração
| DocumentDB detalhes da instância | Descrição |
|---|---|
| ARN de instância | O Amazon Resource Name (ARN) da instância do DocumentDB. |
| Cluster ARN | O ARN do cluster DocumentDB que contém a instância. |
| Horário de criação da instância | A hora em que a instância é criada e adicionada ao cluster. |
| Nome | O nome da instância do DocumentDB. |
| Camada de promoção | A função que uma instância desempenha no cluster no momento do failover e da alta disponibilidade. A instância com o menor valor de nível de promoção (normalmente 1) tem a maior prioridade para se tornar a nova primária. |
Métrica
A tabela a seguir descreve os detalhes das métricas da instância do Amazon DocumentDB:
| Métricas do nó | Descrição |
|---|---|
| Utilização da CPU | A porcentagem de uso da CPU. |
| Conexões com o banco de dados | O número de conexões que estão abertas em uma instância, que são coletadas com uma frequência de um minuto. |
| Máximo de conexões com o banco de dados | O número máximo de conexões de banco de dados que são abertas em uma instância em um minuto. |
| Conexões com o banco de dados usadas | Conexões de banco de dados ÷ Máximo de conexões de banco de dados * 100. |
| ReadIOPs | O número médio de operações de leitura de disco por segundo. |
| WriteIOPs | O número médio de operações de gravação em disco por segundo. |
| Documentos excluídos | O número de documentos que são excluídos em um minuto. |
| Documentos inseridos | O número de documentos que são inseridos em um minuto. |
| Documentos atualizados | O número de documentos que são atualizados em um minuto. |
| Documentos devolvidos | O número de documentos que são retornados em um minuto. |
| Rendimento de leitura | O número médio de bytes que são lidos do disco por segundo. |
| Rendimento de gravação | O número médio de bytes gravados no disco por segundo. |
| Transações abertas | O número de transações que estão abertas em uma instância em um minuto. |
| Máximo de transações abertas | O número máximo de transações que estão abertas em uma instância em um minuto. |
| Transações abertas usadas | Transações em aberto ÷ Transações em aberto máximo * 100. |
| Latência de leitura | O tempo médio necessário para operações de E/S de leitura de disco. |
| Latência de gravação | O tempo médio (em milissegundos) gasto por operação de E/S de disco. |
| DBInstance ReplicaLag | A quantidade de atraso quando as atualizações são replicadas da instância primária para uma instância de réplica. |
| Transações iniciadas | O número de transações que são iniciadas em um minuto. |
| Transações interrompidas | O número de transações que são abortadas em um minuto. |
| Transações confirmadas | O número de transações que são confirmadas em um minuto. |
DocumentDB conjunto elástico
O sensor Amazon DocumentDB coleta os seguintes dados do cluster elástico Amazon DocumentDB:
Dados de configuração
| DocumentDB detalhes do cluster elástico | Descrição |
|---|---|
| ARN | O Amazon Resource Name (ARN) do cluster elástico do DocumentDB. |
| Tipo de cluster | O tipo de cluster (baseado em instância ou elástico). |
| Horário de criação do cluster | A hora em que o cluster é criado. |
| Nome | O nome do cluster. |
Métrica
| Métricas de cluster | Descrição |
|---|---|
| Utilização da CPU | A porcentagem de uso da CPU da instância primária. |
| DatabaseConnections | O número de conexões que estão abertas em um cluster, que são coletadas com uma frequência de um minuto. |
| Volume ReadIOPs | O número médio de operações de E/S de leitura faturadas de um volume de cluster que são relatadas em intervalos de 5 minutos. |
| Volume WriteIOPs | O número médio de operações de E/S de gravação faturadas de um volume de cluster que são relatadas em intervalos de 5 minutos. |
| Documentos excluídos | O número de documentos que são excluídos em um minuto. |
| Documentos inseridos | O número de documentos que são inseridos em um minuto. |
| Documentos atualizados | O número de documentos que são atualizados em um minuto. |
| Documentos devolvidos | O número de documentos que são retornados em um minuto. |
| Rendimento de leitura | O número médio de bytes que são lidos do disco por segundo. |
| Rendimento de gravação | O número médio de bytes gravados no disco por segundo. |