O Active Directory Domain Services (AD DS) armazena informações sobre objetos na rede para que administradores e usuários possam acessá-las facilmente.
Para mais informações sobre o AD DS, consulte a Documentação dos Serviços de Domínio do Active Directory (AD DS).
Pré-requisitos
Para coletar a telemetria do AD DS, é preciso instalar o agente de operações:
- Para métricas, instale a versão 2.15.0 ou mais recente.
- Para registros, instale a versão 2.15.0 ou posterior.
Essa integração é compatível com as versões windows-server-2016 e windows-server-2019 do AD DS.
Configurar sua instância do AD DS
Por padrão, os logs de eventos do Windows e os contadores de desempenho do Active Directory estão ativados.
Configurar o agente de operações para o AD DS
Seguindo o guia para Configurar o Agente Agente, adicione os elementos necessários para coletar telemetria de instâncias do AD DS e reinicie o agente.
Exemplo de configuração
Os comandos a seguir criam a configuração para coletar e ingerir a telemetria para o AD DS e reinicie o Agente de operações.
Configurar a coleta de registros
Para ingerir registros do AD DS, você precisa criar um receptor para os registros que o AD DS produz e cria um pipeline para o novo receptor.
active_directory_ds
Para configurar um receptor para os registros , especifique os seguintes campos:
Campo | Padrão | Descrição |
---|---|---|
type |
O valor precisa ser active_directory_ds . |
O que é registrado
O logName
é derivado dos
IDs do receptor especificados na configuração. Os campos
detalhados dentro de LogEntry
são os seguintes.
Os registros active_directory_ds
contêm os seguintes campos no LogEntry
:
Campo | Tipo | Descrição |
---|---|---|
jsonPayload.Channel |
string | Canal de log de eventos em que o log foi registrado. |
jsonPayload.ComputerName |
string | O nome do computador de origem do log. |
jsonPayload.Data |
string | Dados extras específicos do evento incluídos no registro. |
jsonPayload.EventCategory |
number | A categoria do evento. |
jsonPayload.EventID |
number | Um ID que identifica o tipo do evento. |
jsonPayload.EventType |
string | O tipo de evento. |
jsonPayload.Message |
string | A mensagem de registro. |
jsonPayload.Qualifiers |
number | Um número de qualificador usado para a identificação de eventos. |
jsonPayload.RecordNumber |
number | O número da sequência do log de eventos. |
jsonPayload.Sid |
string | O identificador de segurança que identifica o principal ou o grupo de segurança do processo que registrou a mensagem. |
jsonPayload.SourceName |
string | O componente de origem que registrou esta mensagem. |
jsonPayload.StringInserts |
[]string | Dados de string dinâmicos usados para criar a mensagem de registro. |
jsonPayload.TimeGenerated |
string | Um carimbo de data/hora que representa quando o registro foi gerado. |
jsonPayload.TimeWritten |
string | Um carimbo de data/hora que representa quando o registro foi gravado no log de eventos. |
severity |
string (LogSeverity ) |
Nível de entrada de registro (traduzido). |
Configurar a coleta de métricas
Para ingerir métricas do AD DS, você precisa criar um receptor para as métricas produzidas pelo AD DS e, em seguida, criar um pipeline para o novo receptor.
Esse receptor não aceita o uso de várias instâncias na configuração, por exemplo, para monitorar vários endpoints. Todas essas instâncias gravam na mesma série temporal, e o Cloud Monitoring não tem como diferenciá-las.
Para configurar um receptor para suas
métricas do active_directory_ds
, especifique os campos
a seguir:
Campo | Padrão | Descrição |
---|---|---|
collection_interval |
60s |
Um valor de time.Duration, como 30s ou 5m . |
type |
O valor precisa ser active_directory_ds . |
O que é monitorado?
A tabela a seguir fornece a lista de métricas que o agente de operações coleta da instância do AD DS.
Tipo de métrica | |
---|---|
Tipo, tipo Recursos monitorados |
Rótulos |
workload.googleapis.com/active_directory.ds.bind.rate
|
|
GAUGE , DOUBLE gce_instance |
type
|
workload.googleapis.com/active_directory.ds.ldap.bind.last_successful.time
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/active_directory.ds.ldap.bind.rate
|
|
GAUGE , DOUBLE gce_instance |
|
workload.googleapis.com/active_directory.ds.ldap.client.session.count
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/active_directory.ds.ldap.search.rate
|
|
GAUGE , DOUBLE gce_instance |
|
workload.googleapis.com/active_directory.ds.name_cache.hit_rate
|
|
GAUGE , DOUBLE gce_instance |
|
workload.googleapis.com/active_directory.ds.notification.queued
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/active_directory.ds.operation.rate
|
|
GAUGE , DOUBLE gce_instance |
type
|
workload.googleapis.com/active_directory.ds.replication.network.io
|
|
CUMULATIVE , INT64 gce_instance |
direction type
|
workload.googleapis.com/active_directory.ds.replication.object.rate
|
|
GAUGE , DOUBLE gce_instance |
direction
|
workload.googleapis.com/active_directory.ds.replication.operation.pending
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/active_directory.ds.replication.property.rate
|
|
GAUGE , DOUBLE gce_instance |
direction
|
workload.googleapis.com/active_directory.ds.replication.sync.object.pending
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/active_directory.ds.replication.sync.request.count
|
|
CUMULATIVE , INT64 gce_instance |
result
|
workload.googleapis.com/active_directory.ds.replication.value.rate
|
|
GAUGE , DOUBLE gce_instance |
direction type
|
workload.googleapis.com/active_directory.ds.security_descriptor_propagations_event.queued
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/active_directory.ds.suboperation.rate
|
|
GAUGE , DOUBLE gce_instance |
type
|
workload.googleapis.com/active_directory.ds.thread.count
|
|
GAUGE , INT64 gce_instance |
Verificar a configuração
Esta seção descreve como verificar se você configurou corretamente o receptor do AD DS. Pode levar um ou dois minutos para que o agente de operações comece a coletar telemetria.
Para verificar se os registros do DS estão sendo enviados para o Cloud Logging, faça o seguinte:
-
No console do Google Cloud, acesse a página do Análise de registros.
Acessar a Análise de registros
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Geração de registros.
- Digite a consulta a seguir no Editor e clique em Executar consulta:
resource.type="gce_instance" log_id("active_directory_ds")
Para verificar se as métricas do DS estão sendo enviadas para o Cloud Monitoring, faça o seguinte:
-
No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- Verifique se MQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
- Digite a consulta a seguir no Editor e clique em Executar consulta:
fetch gce_instance | metric 'workload.googleapis.com/active_directory.ds.bind.rate' | every 1m
Ver painel
Para visualizar as métricas do AD DS, é necessário ter um gráfico ou um painel configurado. A integração do AD DS inclui um ou mais painéis para você. Todos os painéis são instalados automaticamente depois que você configura a integração e o Agente de operações começa a coletar dados de métricas.
Também é possível ver visualizações estáticas de painéis sem instalar a integração.
Para ver um painel instalado, faça o seguinte:
-
No console do Google Cloud, acesse a página
Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Selecione a guia Lista de painéis e escolha a categoria Integrações.
- Clique no nome do painel que você quer visualizar.
Se você configurou uma integração, mas o painel não foi instalado, verifique se o agente de operações está em execução. Quando não há dados de métricas para um gráfico no painel, a instalação do painel falha. Depois que o Agente de operações começar a coletar métricas, o painel será instalado para você.
Para acessar uma visualização estática do painel, faça o seguinte:
-
No console do Google Cloud, acesse a página
Integrações:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Clique no filtro de plataforma de implantação do Compute Engine.
- Localize a entrada para DS e clique em Ver detalhes.
- Selecione a guia Painéis para uma visualização estática. Se o painel estiver instalado, navegue até ele clicando em Ver painel.
Para mais informações sobre painéis no Cloud Monitoring, consulte Painéis e gráficos.
Para mais informações sobre como usar a página Integrações, consulte Gerenciar integrações.
Instalar políticas de alertas
As políticas de alertas orientam o Cloud Monitoring a notificar você quando ocorrerem condições especificadas. A integração do AD DS inclui uma ou mais políticas de alertas para você usar. É possível ver e instalar essas políticas de alertas na página Integrações no Monitoring.
Para visualizar e descrever as descrições de políticas de alertas disponíveis, faça o seguinte:
-
No console do Google Cloud, acesse a página
Integrações:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
- Localize a entrada para DS e clique em Ver detalhes.
- Selecione a guia Alertas. Essa guia apresenta descrições das políticas de alertas disponíveis e mostra uma interface para instalá-las.
- Instalar políticas de alertas. As políticas de alertas precisam
saber para onde enviar as notificações de que o alerta foi
acionado. Portanto, elas exigem informações para instalação.
Para instalar políticas de alertas, faça o seguinte:
- Na lista de políticas de alertas disponíveis, selecione aquelas que você quer instalar.
Na seção Configurar notificações, selecione um ou mais canais de notificação. Você pode desativar o uso dos canais de notificação, mas, se isso acontecer, as políticas de alertas vão ser disparadas silenciosamente. É possível verificar o status no Monitoring, mas não receber notificações.
Para saber mais sobre canais de notificação, consulte Gerenciar canais de notificação.
- Clique em Criar políticas.
Para mais informações sobre políticas de alertas no Cloud Monitoring, consulte Introdução a alertas.
Para mais informações sobre como usar a página Integrações, consulte Gerenciar integrações.
A seguir
Para ver um tutorial sobre como usar o Ansible para instalar o agente de operações, configurar um aplicativo de terceiros e instalar um painel de amostra, consulte o vídeo Instalação do agente de operações para resolver problemas de aplicativos de terceiros.