Integração com Datadog
Nesta página
Você pode configurar o Atlas para enviar dados de métricas sobre seu projeto para seus dashboards de Datadog.
Observação
Se configurar seu projeto do Atlas para enviar alertas e eventos para Datadog, você não precisará seguir este procedimento. O Atlas envia as métricas do projeto para o Datadog por meio da mesma integração usada para enviar alertas e eventos.
Você também pode configurar o Datadog para receber alertas do Atlas. Para saber mais, consulte Opções de notificação.
Acesso necessário
Para integrar Atlas com Datadog, você deve ter acesso do Project Owner ao projeto. Os usuários com acesso ao Organization Owner devem adicionar-se ao projeto como um Project Owner.
Pré-requisitos
A integração do Datadog está disponível somente em clusters M10+.
Observação
As tags não são compatíveis com integrações do Datadog. Se você fizer a integração com o Datadog, continue usando rótulos. Para definir rótulos, use o parâmetro labels no endpoint Modificar um cluster da API.
Para integrar o Atlas ao Datadog, você deve ter uma conta Datadog e uma chave de API Datadog. O Datadog concede uma chave de API quando você cria uma conta Datadog pela primeira vez.
Caso não tenha uma conta Datadog, você pode se cadastrar em https://app.datadoghq.com/signup.
Procedimento
Para criar ou atualizar uma integração do Datadog utilizando o Atlas CLI, execute o seguinte comando:
atlas integrations create DATADOG [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para criar atlas integrations DATADOG.
Para configurar uma integração Atlas com Datadog usando a interface do usuário do Atlas:
1
No Atlas, acesse a página Project Integrations.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Ao lado do menu Projects, expanda o menu Options e clique em Integrations.
A página Integrações de projeto é exibida.
2
Vincule o Datadog ao seu projeto usando sua chave de API do Datadog.
Clique em Configure para obter o cartão de integração do Datadog.
Insira sua chave API Datadog na caixa de entrada.
Selecione a região da sua API.
O Atlas é compatível com as seguintes regiões do Datadog na UI do Atlas:
US1US3US5EU1AP1
O Datadog utiliza
US1por padrão.Para saber mais sobre as regiões de Datadog, consulte Sites de Datadog.
Clique em Save.
Métricas de desempenho disponíveis para o Datadog
O Datadog rastreia os seguintes dados de métrica para seu cluster do Atlas. Os nomes das métricas entre parênteses são os nomes usados na interface do usuário do Datadog.
Nomes de métricas | Tipo de métrica | Descrição |
|---|---|---|
CONNECTIONS(mongodb.atlas.connections.current) | Processo | Número de conexões abertas atualmente abertas no cluster. |
DB_STORAGE_TOTAL(mongodb.atlas.stats.totalstoragesize) DB_DATA_SIZE_TOTAL(mongodb.atlas.stats.totaldatasize) DB_INDEX_SIZE_TOTAL(mongodb.atlas.stats.totalindexsize) | Processo | Tamanho total do armazenamento do banco de dados, tamanho dos dados e tamanho do índice no cluster em bytes. |
DISK_LATENCY_READS(mongodb.atlas.system.disk.latency.reads) DISK_LATENCY_WRITES(mongodb.atlas.system.disk.latency.writes) | Disk | Taxa de latência em milissegundos para solicitações de leitura e solicitações de gravação. |
DISK_MAX_LATENCY_READS(mongodb.atlas.system.disk.max.latency.reads) DISK_MAX_LATENCY_WRITES(mongodb.atlas.system.disk.max.latency.writes) | Disk | Medidor de latência máxima em milissegundos para solicitações de leitura e solicitações de gravação. |
DISK_QUEUE_DEPTH(mongodb.atlas.system.disk.queuedepth) | Disk | Comprimento médio da fila de solicitações emitidas para a partição de disco que o MongoDB usa durante o período de tempo especificado pela granularidade métrica. |
MAX_DISK_QUEUE_DEPTH(mongodb.atlas.system.disk.max.queuedepth) | Disk | Valores máximos durante o período de tempo especificado pela granularidade métrica para o comprimento médio da fila de solicitações emitidas para a partição de disco que o MongoDB usa. |
DOCUMENT_METRICS_RETURNED(mongodb.atlas.metrics.document.returned) DOCUMENT_METRICS_INSERTED(mongodb.atlas.metrics.document.inserted) DOCUMENT_METRICS_UPDATED(mongodb.atlas.metrics.document.updated) DOCUMENT_METRICS_DELETED(mongodb.atlas.metrics.document.deleted) | Processo | Número de documentos lidos ou escritos por segundo. |
NETWORK_BYTES_IN(mongodb.atlas.network.bytes.in) | Processo | Taxa média de bytes físicos (após qualquer compressão de fio) enviada para o servidor do banco de dados por segundo. |
NETWORK_BYTES_OUT(mongodb.atlas.network.bytes.out) | Processo | Taxa média de bytes físicos (após qualquer compressão de fio) enviada do servidor do banco de dados por segundo. |
NETWORK_NUM_REQUESTS(mongodb.atlas.network.num.requests) | Processo | Taxa média de solicitações enviadas ao servidor do banco de dados por segundo. |
OPCOUNTER_CMD(mongodb.atlas.opcounters.command) OPCOUNTER_QUERY(mongodb.atlas.opcounters.query) OPCOUNTER_UPDATE(mongodb.atlas.opcounters.update) OPCOUNTER_DELETE(mongodb.atlas.opcounters.delete) OPCOUNTER_GETMORE(mongodb.atlas.opcounters.getmore) OPCOUNTER_INSERT(mongodb.atlas.opcounters.insert) | Processo | Número de operações por segundo, separadas por tipo de operação. |
OP_EXECUTION_TIME_READS(mongodb.atlas.oplatencies.reads.avg) OP_EXECUTION_TIME_WRITES(mongodb.atlas.oplatencies.writes.avg) OP_EXECUTION_TIME_COMMANDS(mongodb.atlas.oplatencies.commands.avg) | Processo | Tempo médio de operação em milissegundos, separado por tipo de operação. |
QUERY_TARGETING_SCANNED_OBJECTS_PER_RETURNED(mongodb.atlas.metrics.queryexecutor.scannedobjectsperreturned) | Processo | Proporção que mede o número de objetos escaneados em relação aos objetos retornados. Valores mais baixos indicam queries mais eficientes. |
REPLICATION_LAG(mongodb.atlas.replset.replicationlag) | Processo | Quantidade de tempo em segundos que atualiza para o atraso secundário atrás das atualizações para o principal. |
REPLICATION_OPLOG_WINDOW(mongodb.atlas.replset.oplogWindow) | Processo | Número médio estimado, em segundos, de operações de banco de dados disponíveis no oplog de replicação do primário. Esta métrica é baseada na rotatividade de oplog. Uma ressincronização completa será necessária se o atraso de replicação em um nó secundário exceder a oplog window de replicação e o espaço de replicação chegar a zero. |
REPLICATION_STATUS_HEALTH(mongodb.atlas.replstatus.health) | Processo | Número que indica a integridade de um membro do conjunto de réplicas. Um valor de Você pode ver um status de saúde impreciso nos seguintes cenários:
IMPORTANTE: Se o status de saúde for |
REPLICATION_STATUS_STATE(mongodb.atlas.replstatus.state) | Processo | |
SYSTEM_MEMORY_USED(mongodb.atlas.system.memory.used) SYSTEM_MEMORY_AVAILABLE(mongodb.atlas.system.memory.available) | Sistema | Medidor que indica a memória física usada, em bytes. |
MAX_SYSTEM_MEMORY_USED(mongodb.atlas.system.memory.max.used) MAX_SYSTEM_MEMORY_AVAILABLE(mongodb.atlas.system.memory.max.available) | Sistema | Medidor que indica a memória física máxima usada, em bytes. |
SYSTEM_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.norm.user) SYSTEM_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.norm.kernel) SYSTEM_NORMALIZED_CPU_NICE(mongodb.atlas.system.cpu.norm.nice) SYSTEM_NORMALIZED_CPU_IOWAIT(mongodb.atlas.system.cpu.norm.iowait) SYSTEM_NORMALIZED_CPU_IRQ(mongodb.atlas.system.cpu.norm.irq) SYSTEM_NORMALIZED_CPU_SOFTIRQ(mongodb.atlas.system.cpu.norm.softirq) SYSTEM_NORMALIZED_CPU_GUEST(mongodb.atlas.system.cpu.norm.guest) SYSTEM_NORMALIZED_CPU_STEAL(mongodb.atlas.system.cpu.norm.steal) | Sistema | Porcentagem de tempo utilizado por CPUs lógicas em vários processos do servidor. Esses valores são normalizados em relação ao número de núcleos lógicos da CPU. |
MAX_SYSTEM_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.max.norm.user) MAX_SYSTEM_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.max.norm.kernel) MAX_SYSTEM_NORMALIZED_CPU_NICE(mongodb.atlas.system.cpu.max.norm.nice) MAX_SYSTEM_NORMALIZED_CPU_IOWAIT(mongodb.atlas.system.cpu.max.norm.iowait) MAX_SYSTEM_NORMALIZED_CPU_IRQ(mongodb.atlas.system.cpu.max.norm.irq) MAX_SYSTEM_NORMALIZED_CPU_SOFTIRQ(mongodb.atlas.system.cpu.max.norm.softirq) MAX_SYSTEM_NORMALIZED_CPU_GUEST(mongodb.atlas.system.cpu.max.norm.guest) MAX_SYSTEM_NORMALIZED_CPU_STEAL(mongodb.atlas.system.cpu.max.norm.steal) | Sistema | Valores máximos no período especificado pela granularidade da métrica para a porcentagem de tempo utilizada pelas CPUs lógicas em vários processos do servidor. Esses valores são normalizados em relação ao número de núcleos lógicos da CPU. |
PROCESS_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.mongoprocess.norm.user) PROCESS_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.mongoprocess.norm.kernel) PROCESS_NORMALIZED_CPU_CHILDREN_USER(mongodb.atlas.system.cpu.mongoprocess.norm.childrenuser) PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL(mongodb.atlas.system.cpu.mongoprocess.norm.childrenkernel) | Processo | Porcentagem de tempo utilizado por CPUs lógicas em vários processos específicos para o processo MongoDB no servidor. Esses valores são normalizados em relação ao número de núcleos lógicos da CPU. |
MAX_PROCESS_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.mongoprocess.max.norm.user) MAX_PROCESS_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.mongoprocess.max.norm.kernel) MAX_PROCESS_NORMALIZED_CPU_CHILDREN_USER(mongodb.atlas.system.cpu.mongoprocess.max.norm.childrenuser) MAX_PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL(mongodb.atlas.system.cpu.mongoprocess.max.norm.childrenkernel) | Processo | Valores máximos durante o período especificado pela granularidade métrica para a porcentagem de tempo utilizada pelas CPUs lógicas em vários processos específicos do processo MongoDB no servidor. Esses valores são normalizados em relação ao número de núcleos lógicos da CPU. |
MEMORY_RESIDENT(mongodb.atlas.mem.resident) MEMORY_VIRTUAL(mongodb.atlas.mem.virtual) | Processo | Memória (em MB) consumida pelo processo MongoDB no servidor, separada por tipo de memória. |
OPCOUNTER_REPL_CMD(mongodb.atlas.opcountersrepl.command) OPCOUNTER_REPL_UPDATE(mongodb.atlas.opcountersrepl.update) OPCOUNTER_REPL_DELETE(mongodb.atlas.opcountersrepl.delete) OPCOUNTER_REPL_INSERT(mongodb.atlas.opcountersrepl.insert) | Processo | Meça a taxa de operações de banco de dados em secundários do MongoDB, conforme coletado no documento Você pode visualizar essas métricas no gráfico Opcounters - Repl, acessado por meio de Métricas de cluster. |
OPLOG_RATE_GB_PER_HOUR(mongodb.atlas.replset.oplograte) | Processo | A taxa média de oplog que o primário gera em gigabytes por hora. |
TOTAL_NUMBER_OF_GETMORE_COMMANDS(mongodb.atlas.search.index.stats.commands.getmore) | Atlas Search | Número total de comandos do getmore executados em todas as consultas de Pesquisa do Atlas. |
TOTAL_NUMBER_OF_DELETES(mongodb.atlas.search.index.stats.deletes) | Atlas Search | Número total de documentos ou campos (especificados na definição do índice) removidos. |
TOTAL_NUMBER_OF_INDEX_FIELD(mongodb.atlas.search.index.stats.index.fields) | Atlas Search | Número total de campos únicos presentes no índice de Pesquisa do Atlas. |
TOTAL_INDEX_SIZE_ON_DISK(mongodb.atlas.search.index.stats.index.size) | Atlas Search | Tamanho total de todos os índices no disco. |
TOTAL_NUMBER_OF_INSERTS_SERIES(mongodb.atlas.search.index.stats.inserts) | Atlas Search | Número total de documentos ou campos (especificados na definição de índice) que a Atlas Search indexou. |
MAX_REPLICATION_LAG(mongodb.atlas.search.index.stats.max.replication.lag) | Atlas Search | |
TOTAL_NUMBER_OF_UPDATES(mongodb.atlas.search.index.stats.updates) | Atlas Search | Número total de documentos ou campos (especificados na definição de índice) que a Atlas Search indexou. |
TOTAL_NUMBER_OF_ERROR_QUERIES(mongodb.atlas.search.index.stats.queries.error) | Atlas Search | Número total de consultas para as quais a Pesquisa Atlas não pode retornar uma resposta. |
TOTAL_NUMBER_OF_SUCCESS_QUERIES(mongodb.atlas.search.index.stats.queries.success) | Atlas Search | Número total de queries para as quais a Atlas Search devolveu com sucesso uma resposta. |
TOTAL_NUMBER_OF_TOTAL_QUERIES(mongodb.atlas.search.index.stats.queries.total) | Atlas Search | Número total de consultas submetidas à Pesquisa Atlas. |
JVM_CURRENT_MEMORY(mongodb.atlas.search.jvm.current.memory) | Atlas Search | Quantidade de memória que o heap da JVM está usando atualmente. |
JVM_MAX_MEMORY(mongodb.atlas.search.jvm.max.memory) | Atlas Search | Total de memória disponível no heap do JVM. |
DISK_PARTITION_SPACE_FREE(mongodb.atlas.system.disk.space.free) DISK_PARTITION_SPACE_USED(mongodb.atlas.system.disk.space.used) DISK_PARTITION_SPACE_PERCENT_FREE(mongodb.atlas.system.disk.space.percentfree) DISK_PARTITION_SPACE_PERCENT_USED(mongodb.atlas.system.disk.space.percentused) | Disk | Meça o espaço livre em disco e o espaço em disco usado (em bytes) na partição de disco usada pelo MongoDB. |
MAX_DISK_PARTITION_SPACE_FREE(mongodb.atlas.system.disk.max.space.free) MAX_DISK_PARTITION_SPACE_USED(mongodb.atlas.system.disk.max.space.used) MAX_DISK_PARTITION_SPACE_PERCENT_FREE(mongodb.atlas.system.disk.max.space.percentfree) MAX_DISK_PARTITION_SPACE_PERCENT_USED(mongodb.atlas.system.disk.max.space.percentused) | Disk | Valores máximos durante o período de tempo especificado pela granularidade métrica para espaço livre em disco e espaço em disco usado (em bytes) na partição de disco usada pelo MongoDB. |
DISK_PARTITION_IOPS_READ(mongodb.atlas.system.disk.iops.reads) DISK_PARTITION_IOPS_WRITE(mongodb.atlas.system.disk.iops.writes) DISK_PARTITION_IOPS_TOTAL(mongodb.atlas.system.disk.iops.total) | Disk | Meça a taxa de transferência de IOPS para a partição de disco usada pelo MongoDB. |
MAX_DISK_PARTITION_IOPS_READ(mongodb.atlas.system.disk.max.iops.reads) MAX_DISK_PARTITION_IOPS_WRITE(mongodb.atlas.system.disk.max.iops.writes) MAX_DISK_PARTITION_IOPS_TOTAL(mongodb.atlas.system.disk.max.iops.total) | Disk | Valores máximos durante o período especificado pela granularidade métrica para a taxa de transferência de IOPS para a partição de disco usada pelo MongoDB. |
SYSTEM_NETWORK_BYTES_IN(mongodb.atlas.system.network.bytes.in) | Sistema | Taxa média de bytes físicos recebidos por segundo. |
SYSTEM_NETWORK_BYTES_OUT(mongodb.atlas.system.network.bytes.out) | Sistema | Taxa média de bytes físicos transmitidos por segundo. |
MAX_SYSTEM_NETWORK_IN(mongodb.atlas.system.network.max.bytes.in) | Sistema | Valores máximos durante o período especificado pela granularidade da métrica para a taxa média de bytes físicos recebidos por segundo. |
MAX_SYSTEM_NETWORK_OUT(mongodb.atlas.system.network.max.bytes.out) | Sistema | Valores máximos durante o período especificado pela granularidade da métrica para a taxa média de bytes físicos transmitidos por segundo. |
CACHE_BYTES_READ_INTO(mongodb.atlas.wiredtiger.cache.bytes_read_into_cache) CACHE_BYTES_WRITTEN_FROM(mongodb.atlas.wiredtiger.cache.bytes_written_from_cache) | Processo | Meça a taxa média de bytes lidos e gravados a partir do cache do WiredTiger. |
CACHE_USED_BYTES(mongodb.atlas.wiredtiger.cache.bytes_currently_in_cache) CACHE_DIRTY_BYTES(mongodb.atlas.wiredtiger.cache.tracked_dirty_bytes_in_cache) | Processo | Meça o número de bytes de dados e o número de bytes de dados sujos no cache do WiredTiger. |
PAGES_READ_INTO_CACHE(mongodb.atlas.wiredtiger.cache.pages_read_into_cache) PAGES_REQUESTED_FROM_CACHE(mongodb.atlas.wiredtiger.cache.pages_requested_from_the_cache) | Processo | Número de páginas lidas no cache e o número de páginas solicitadas do cache. |
TICKETS_AVAILABLE_READS(mongodb.atlas.wiredtiger.concurrenttransactions.read.available) TICKETS_AVAILABLE_WRITES(mongodb.atlas.wiredtiger.concurrenttransactions.write.available) | Processo | Meça o número de operações de leitura e grave no mecanismo de armazenamento. |
GLOBAL_LOCK_CURRENT_QUEUE_READERS(mongodb.atlas.global.lock.current.queue.readers) GLOBAL_LOCK_CURRENT_QUEUE_WRITERS(mongodb.atlas.global.lock.current.queue.writers) GLOBAL_LOCK_CURRENT_QUEUE_TOTAL(mongodb.atlas.global.lock.current.queue.total) | Global | Medidor que indica o número de operações atualmente na fila devido a bloqueios que o Atlas mantém em leituras, gravações ou leituras e gravações combinadas. |
AVG_OBJECT_SIZE(dbstats.avg.object.size) | Medidor | Tamanho médio de cada documento em bytes. Este é o dataSize dividido pelo número de documentos. O argumento de escala não afeta o valor de avgObjSize. |
COLLECTIONS(mongodb.atlas.dbstats.collections) | Medidor | Número de collections no banco de dados. |
DATA_SIZE(mongodb.atlas.dbstats.data.size) | Medidor | Tamanho total dos dados não comprimidos mantidos no banco de dados. |
FILE_SIZE(mongodb.atlas.dbstats.file.size) | Medidor | Tamanho total de todo o espaço em disco em uso no sistema de arquivos onde o MongoDB armazena dados. |
INDEX_SIZE(mongodb.atlas.dbstats.index.size) | Medidor | Soma do espaço em disco alocado a todos os índices no banco de dados, incluindo espaço de índice livre. |
INDEXES(mongodb.atlas.dbstats.indexes) | Medidor | Número total de índices em todas as collections no banco de dados. |
NUM_EXTENTS(mongodb.atlas.dbstats.num.extents) | Medidor | Contém uma contagem do número de extensões no banco de dados em todas as coleções. |
OBJECTS(mongodb.atlas.dbstats.objects) | Medidor | Número de objetos (especificamente, documentos) no banco de dados em todas as coleções. |
STORAGE_SIZE(mongodb.atlas.dbstats.storage.size) | Medidor | Soma do espaço em disco alocado a todas as coleções no banco de dados para armazenamento de documentos, incluindo o espaço livre. |
VIEWS(mongodb.atlas.dbstats.views) | Medidor | Número de visualizações no banco de dados. |
COLLECTION_READ_LATENCY(mongodb.atlas.latencyStats.read.sum) COLLECTION_WRITE_LATENCY(mongodb.atlas.latencyStats.write.sum) COLLECTION_COMMANDS_LATENCY(mongodb.atlas.latencyStats.write.sum) COLLECTION_TOTAL_LATENCY(mongodb.atlas.latencyStats.total.sum) | Contador | Um inteiro de 64bits que fornece a latência em microssegundos para solicitações de leitura, gravação, comando e total. |
COLLECTION_READ_OPS(mongodb.atlas.latencyStats.read.count) COLLECTION_WRITE_OPS(mongodb.atlas.latencyStats.write.count) COLLECTION_COMMANDS_OPS(mongodb.atlas.latencyStats.write.count) COLLECTION_TOTAL_OPS(mongodb.atlas.latencyStats.total.count) | Contador | Um inteiro de 64bits que informa o número de operações realizadas na coleção desde a inicialização para solicitações de leitura, gravação, comando e total. |
READ_HISTOGRAM_P50(mongodb.atlas.latencyStats.read.p50) WRITE_HISTOGRAM_P50(mongodb.atlas.latencyStats.write.p50) COMMANDS_HISTOGRAM_P50(mongodb.atlas.latencyStats.commands.p50) TOTAL_HISTOGRAM_P50(mongodb.atlas.latencyStats.total.p50) | Contador | Número de operações no 50º percentil no histograma de latência para solicitações de leitura, gravação, comando e total. |
READ_HISTOGRAM_P95(mongodb.atlas.latencyStats.read.p95) WRITE_HISTOGRAM_P95(mongodb.atlas.latencyStats.write.p95) COMMANDS_HISTOGRAM_P95(mongodb.atlas.latencyStats.commands.p95) TOTAL_HISTOGRAM_P95(mongodb.atlas.latencyStats.total.p95) | Contador | Número de operações no 95º percentil no histograma de latência para solicitações de leitura, gravação, comando e total. |
READ_HISTOGRAM_P99(mongodb.atlas.latencyStats.read.p99) WRITE_HISTOGRAM_P99(mongodb.atlas.latencyStats.write.p99) COMMANDS_HISTOGRAM_P99(mongodb.atlas.latencyStats.commands.p99) TOTAL_HISTOGRAM_P99(mongodb.atlas.latencyStats.total.p99) | Contador | Número de operações no 99º percentil no histograma de latência para solicitações de leitura, gravação, comando e total. |
Tags disponíveis para o Datadog
Além de qualquer tags de cluster, o Datadog envia as seguintes tags como rótulos em determinadas métricas:
Datadog Tags | Descrição |
|---|---|
organizationname | A organização Atlas associada à métrica. |
projectname | O projeto Atlas associado à métrica. |
clustername | O cluster do Atlas associado à métrica. |
replicasetname | O conjunto de réplicas associado à métrica. |
shardedclustername | O cluster fragmentado associado à métrica. |
databasename | O banco de dados associado à métrica. |
collectionname | A coleção associada à métrica. |
hostnameport | O número da porta associado ao seu nome de host Atlas. |
hostnamestate | O estado de seu nome de host do Atlas (primário, secundário ou processo individual). Você pode usar essa tag para filtrar métricas de latência em nível de coleção ao consultar seu cluster fragmentado ou conjunto de réplicas. |