> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fonte MongoDB do Vector

Obtenha mais insights sobre a operação do seu banco de dados ou cluster MongoDB com nossa integração Vector MongoDB.

O [Vector](https://vector.dev) tem uma [fonte MongoDB][source] que coleta métricas das suas instâncias MongoDB. Quando essas métricas do MongoDB são enviadas ao AppSignal, as métricas desta fonte do Vector serão exibidas nos nossos dashboards automáticos de MongoDB.

## Configuração

<Tip>
  Se você ainda não configurou o Vector, consulte a [seção de configuração
  do Vector](/vector#configuration) para mais informações, como qual chave
  da Push API usar.
</Tip>

Para enviar dados do MongoDB ao AppSignal usando o Vector, você precisará configurar a fonte MongoDB e o sink AppSignal na sua configuração do Vector. Usaremos o arquivo de configuração TOML como exemplo.

1. Adicione uma nova fonte do tipo [`mongodb_metrics` source][source] ao seu arquivo de configuração. O nome da fonte é a parte após o ponto em `sources.mongodb`, não o tipo `mongodb_metrics`.

<CodeGroup>
  ```toml TOML theme={null}
  [sources.mongodb]
  type = "mongodb_metrics"
  ```
</CodeGroup>

2. Configure a opção `endpoints` da fonte com a URL do MongoDB do seu banco de dados. Substitua as variáveis (`$VARIABLE_NAME`) pelos valores do seu banco de dados, ou passe-as como variáveis de ambiente. Se estiver rodando um cluster de banco de dados, especifique cada membro do cluster como um endpoint.

<CodeGroup>
  ```toml TOML theme={null}
  [sources.mongodb]
  type = "mongodb_metrics"
  endpoints = ["$MONGODB_URL"]
  # or, if running a MongoDB cluster:
  # endpoints = ["$MONGODB_URL_1", "$MONGODB_URL_2", "$MONGODB_URL_3"]
  ```
</CodeGroup>

3. Atualize `inputs` no sink `appsignal` para incluir o nome da fonte `mongodb_metrics`:

<CodeGroup>
  ```toml TOML theme={null}
  [sinks.appsignal]
  inputs = ["mongodb"]
  # Other config
  ```
</CodeGroup>

Mostrado abaixo está um exemplo de arquivo de configuração `vector.toml`. Seu [método de configuração do Vector][vector config] pode ser diferente.

<CodeGroup>
  ```toml TOML theme={null}
  [sources.mongodb]
  type = "mongodb_metrics"
  endpoints = ["$MONGODB_URL"]

  [sinks.appsignal]
  type = "appsignal"
  inputs = ["mongodb"]
  push_api_key = "Your app-level Push API key"
  ```
</CodeGroup>

[source]: https://vector.dev/docs/reference/configuration/sources/mongodb_metrics/

[vector config]: https://vector.dev/docs/reference/configuration/

## Dashboards

A partir das métricas das suas instâncias MongoDB, configuraremos automaticamente vários dashboards.

### Dashboard de Status

O dashboard de Status foca na saúde geral e atividade das suas instâncias MongoDB.

<img src="https://mintcdn.com/appsignal-715f5a51/MS9b5WO71lSfD5jG/assets/images/screenshots/vector/mongodb-status.png?fit=max&auto=format&n=MS9b5WO71lSfD5jG&q=85&s=7bf5cbbf99ca210fe24d62d17af6030b" alt="Dashboard de Status" width="2248" height="1934" data-path="assets/images/screenshots/vector/mongodb-status.png" />

Ele reportará gráficos para uso de memória, uso de rede, operações de documentos e conexões abertas.

Este dashboard permite que você identifique rapidamente o que está impactando seu banco de dados ou sua aplicação, como uma queda nas conexões de banco de dados ou um aumento no uso de memória.

### Dashboard WiredTiger

O dashboard WiredTiger fornece uma visão aprofundada dos internos do mecanismo de banco de dados MongoDB.

<img src="https://mintcdn.com/appsignal-715f5a51/MS9b5WO71lSfD5jG/assets/images/screenshots/vector/mongodb-wiredtiger.png?fit=max&auto=format&n=MS9b5WO71lSfD5jG&q=85&s=2b3c4ec7ee286f1280d2cf423c481f7a" alt="Dashboard WiredTiger" width="2256" height="1936" data-path="assets/images/screenshots/vector/mongodb-wiredtiger.png" />

Ele reportará gráficos para operações de journal e block manager, a quantidade de bytes lidos e escritos do disco, a quantidade de dados no cache e a quantidade de transações em andamento.

Se você estiver lidando com um problema difícil de rastrear, como uma queda inesperada no desempenho do banco de dados, esses gráficos podem fornecer pistas sobre qual é a causa subjacente.

### Dashboard de Replicação

O dashboard de Replicação fornece uma visão dos internos do sistema de replicação do cluster MongoDB. Este dashboard só aparecerá se você estiver executando um cluster MongoDB.

<img src="https://mintcdn.com/appsignal-715f5a51/MS9b5WO71lSfD5jG/assets/images/screenshots/vector/mongodb-replication.png?fit=max&auto=format&n=MS9b5WO71lSfD5jG&q=85&s=1cc027d9638f77e412bd3122efa15fcf" alt="Dashboard de Replicação" width="2248" height="1934" data-path="assets/images/screenshots/vector/mongodb-replication.png" />

Ele reportará gráficos para a quantidade de uso de rede dedicado à replicação, o tamanho dos buffers de replicação e a quantidade de operações de replicação pendentes de execução.

Este dashboard pode ajudar a investigar problemas relacionados à saúde do seu cluster, como leituras desatualizadas e atrasos de replicação.
