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 você 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 enviaralertas 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 inscrever 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 do Atlas com Datadog usando a IU do Atlas:
1
No Atlas, visite a Project Integrations página .
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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 Datadog.
Clique em Configure para obter o cartão de integração Datadog.
Insira sua chave API Datadog na caixa de entrada.
Selecione sua região de 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 do Datadog, consulte Locais Datadog.
Clique em Save.
Métricas de desempenho disponíveis para o Datadog
Datadog rastreia os seguintes dados de métricas 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 | Medidor de latência em milissegundos para solicitações de leitura e 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 primary. 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:
ImportanteSe 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 primary 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. |
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 escrita 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 collections. |
OBJECTS(mongodb.atlas.dbstats.objects) | Medidor | Número de objetos (especificamente, documentos) no banco de dados em todas as collections. |
STORAGE_SIZE(mongodb.atlas.dbstats.storage.size) | Medidor | Soma do espaço em disco alocado a todas as collections 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 número inteiro de 64bits que informa 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 número inteiro de 64bits que informa o número de operações realizadas na collection 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 50percentil no histograma de latência para leitura, gravação, comando e total de solicitações. |
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 95percentil no histograma de latência para leitura, gravação, comando e total de solicitações. |
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 99percentil no histograma de latência para leitura, gravação, comando e total de solicitações. |
Tags disponíveis para o Datadog
Além de quaisquer 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 Atlas cluster 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 collection associada à métrica. |
hostnameport | O número da porta associada ao seu nome de host Atlas. |
hostnamestate | O estado do seu nome de host Atlas (processo primário, secundário ou individual). Você pode usar essa tag para filtrar as métricas de latência em nível de collection ao consultar seu cluster fragmentado ou conjunto de réplicas. |