Skip to main content
Data Infrastructure Insights
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Referência da ferramenta DII MCP

Colaboradores netapp-alavoie

O servidor DII MCP atualmente expõe 26 ferramentas de produto somente leitura em nove domínios. Um auxiliar mcp_auth separado pode aparecer quando o cliente conectado precisar se autenticar.

Observação O DII MCP é um recurso "Pré-visualização" e, portanto, está sujeito a alterações.

A disponibilidade e os resultados da ferramenta dependem do tenant autenticado, dos recursos DII habilitados, dos coletores configurados e das permissões do usuário.

Convenções de consulta

  • Descubra tipos e metadados antes de consultar campos dinâmicos.

  • Use os nomes exatos de atributos e métricas, com distinção entre maiúsculas e minúsculas, retornados pelos metadados.

  • Use registros de data e hora ISO-8601 e nomes de fuso horário IANA quando necessário.

  • Limite as janelas de consulta a 30 dias ou menos.

  • Use limit e offset para paginação de objetos e alertas.

  • Use o cursor retornado para a paginação de eventos de log.

  • Não exiba os endereços completos dos endpoints de webhook.

Unidades de aquisição

Listar unidades de aquisição

AcquisitionUnitsService_getAcquisitionUnits

Retorna todas as unidades de aquisição com status da conexão, atualização dos relatórios, sistema operacional, versão, endereço IP e contagem de fontes de dados atribuídas.

Exemplo:

Listar unidades de aquisição. Resumir unidades conectadas, com falha e nunca reportadas, sem exibir endereços IP ou UUIDs.

Obtenha uma unidade de aquisição

AcquisitionUnitsService_getAcquisitionUnitByUuid

Recupera todos os detalhes de uma unidade de aquisição. Se você fornecer um nome, liste primeiro as unidades de aquisição para determinar o UUID correspondente.

Entrada necessária: uuid

Alertas

Obter metadados do alerta

ServiçoDeAlertas_obterMetadados

Retorna nomes de campos de alerta e tipos de dados válidos. Chame esta função antes de consultar os alertas.

Consultar alertas

AlertsService_queryForAlerts

Consulta alertas ativos ou inativos com atributos, filtros, ordenação, limites de tempo e paginação por deslocamento selecionados.

Entradas necessárias:

  • active

  • attributeNames

  • fromTime

  • toTime

  • timezone

As entradas opcionais incluem filter, sortField, sortAscending, limit e offset. limit é de 1 a 500; offset é de 0 a 1000. Mantenha o intervalo de tempo abaixo de 30 dias.

Exemplo:

Recupere alertas críticos de armazenamento ativo dos últimos sete dias. Retorne o ID do alerta, o nome do monitor, a gravidade, o status e o nome do armazenamento relacionado.

Receba um alerta pelo nome

AlertsService_getAlertByName

Recupera um alerta usando um ID de alerta no formato AL-123456.

Entrada necessária: name

Receba um alerta por UUID

AlertsService_getAlertByUUID

Recupera um alerta usando seu UUID.

Entrada necessária: uuid

Coletores de dados

Listar fontes de dados

CollectorService_getDataSources

Lista os coletores configurados com nome, status, fornecedor, modelo, unidade de aquisição, versão e última aquisição bem-sucedida. Opcionalmente, permite filtrar por um UUID de AU.

Exemplo:

Agrupe as fontes de dados configuradas por status e fornecedor. Destaque as falhas e as aquisições bem-sucedidas desatualizadas.

Obtenha uma fonte de dados

CollectorService_getDataSourceById

Recupera um coletor com a configuração, o status do pacote de coleta, a atividade de sondagem, os dispositivos descobertos, as informações de patch e o contexto da unidade de aquisição.

Entrada necessária: id

Use esta ferramenta para intervalos de sondagem, métricas configuradas, configurações de coleta ou investigação de falhas.

Liste os tipos de fonte de dados compatíveis

CollectorService_getDataSourceTypes

Lista os tipos de produtos compatíveis com o catálogo de coletores do DII. Esta não é uma lista dos coletores configurados no tenant.

Registros

Listar tipos de log

LogService_getLogTypes

Lista os tipos de log atualmente disponíveis no locatário.

Obter metadados do tipo de log

LogService_getLogTypeMetadata

Retorna os atributos válidos para um tipo de log. Chame esta função antes de pesquisar ou agrupar eventos.

Entrada necessária: type

Eventos de registro de consultas

LogService_queryLogEvents

Retorna os eventos de log em ordem decrescente de data e hora.

Entradas necessárias:

  • type

  • fromTime

  • toTime

  • timezone

As entradas opcionais incluem attributes, filter, limit e cursor. limit é de 1 a 200. A janela de eventos não pode exceder 30 dias. Passe o cursor da resposta anterior para recuperar a próxima página.

Conte os eventos de log ao longo do tempo

LogService_queryLogEventsCountHistogram

Retorna intervalos de tempo de tamanho fixo com a contagem de eventos. Opcionalmente, agrupe cada intervalo por um atributo agrupável válido; os resultados agrupados retornam os principais segmentos e um segmento "__other__".

Entradas necessárias:

  • type

  • fromTime

  • toTime

  • timezone

Entradas opcionais: filter, groupBy

Janelas de manutenção

Liste as janelas de manutenção

MaintenanceWindowService_getMaintenanceWindows

Lista as janelas de supressão de alertas ativas e não expiradas. Defina includeExpired como true para incluir janelas expiradas.

Uma resposta vazia bem-sucedida significa que não existem janelas de manutenção correspondentes.

Obtenha uma janela de manutenção

MaintenanceWindowService_getMaintenanceWindowById

Recupera uma janela de manutenção.

Entrada necessária: id

Monitores

Listar monitores

MonitorsService_queryMonitors

Lista os monitores DII. Use isSystem para retornar apenas os monitores do sistema, excluir os monitores do sistema ou retornar todos os monitores.

Adquira um monitor

MonitorsService_getMonitorById

Recupera um monitor, incluindo sua descrição e orientações corretivas, quando disponíveis.

Entrada necessária: id

Notificações

Listar regras de notificação

NotificationService_getNotificationRules

Lista as regras que encaminham alertas correspondentes para os destinos de notificação. Uma resposta vazia bem-sucedida significa que não existem regras correspondentes.

Obtenha uma regra de notificação

NotificationService_getNotificationRuleById

Recupera uma regra de roteamento.

Entrada necessária: id

Listar destinos de webhook

NotificationService_getWebhooks

Lista os metadados de destino do webhook para Slack, Microsoft Teams, Discord, PagerDuty e integrações HTTP personalizadas. Opcionalmente, filtre por tipos de mecanismo separados por vírgula.

Requisito de segurança: endereços de endpoint completos podem conter credenciais. Aplicativos e agentes devem omitir ou ocultar o campo de endereço dos resultados exibidos ou encaminhados.

Exemplo seguro:

Conte os destinos do webhook por tipo de mecanismo e liste apenas os nomes e o status dos destinos. Não retorne os endereços dos endpoints.

Objetos e métricas

Listar tipos de objeto

ObjectService_getObjectTypes

Lista os tipos de objetos atualmente disponíveis no locatário.

Obter metadados do objeto

ObjectService_getMetadataForObjectType

Retorna atributos, métricas, tipos e capacidades de agrupamento válidos para um tipo de objeto.

Entrada necessária: objectType

Objetos de consulta

ObjectService_query

Recupera objetos, atributos selecionados e métricas opcionais. Os filtros que fazem referência a métricas aplicam-se aos valores brutos antes da agregação por janela temporal.

Entradas necessárias:

  • objectType

  • attributeNames

As entradas opcionais incluem metricNames, filter, sortFieldName, isSortAscending, fromTime, toTime, aggregateFunctions, limit, e offset.

Agregações de consulta suportadas: MAX, MIN, AVG, SUM, LAST. limit é de 1 a 500. Se os limites de tempo forem omitidos, a ferramenta usará como padrão uma janela recente de três horas.

Objetos de grupo

ObjectService_groupObjects

Agrupa objetos por um atributo agrupável válido e agrega as métricas selecionadas. Os filtros são aplicados aos valores brutos antes da agregação.

Entradas necessárias:

  • objectType

  • groupByAttribute

  • metricNames

As entradas opcionais incluem aggregateFunctions, filter, classificação, limites de tempo, limit e offset.

Agregações de grupo suportadas: MAX, MIN, AVG, SUM, FIRST, CHANGE, CHANGE_RATIO.

Séries temporais de desempenho de consultas

consultar métricas de desempenho do ObjectService para objetos

Retorna dados de séries temporais agrupados em buckets para uma métrica e os objetos correspondentes.

Entradas necessárias:

  • objectType

  • metricName

  • fromTime

  • toTime

  • timezone

As entradas opcionais incluem filter, aggregationFunction, limit, e isSortAscending. limit controla o número de séries retornadas e deve ser de 1 a 50.

Agregações de buckets suportadas: MAX, MIN, AVG, SUM, FIRST, CHANGE, CHANGE_RATIO.

Coletores do Kubernetes

Listar coletores do Kubernetes

OperatorsManagement_getKubernetesCollectors

Retorna o nome do cluster, o status geral de atualidade, a versão do operador, a versão do componente Network Performance and Map, a versão do componente Change Analysis e o carimbo de data e hora do último relatório.

Exemplo:

Identifique coletores do Kubernetes desatualizados e resuma quais componentes precisam de atenção.

Operadores de filtro

As consultas de alerta, log e objeto suportam condições aninhadas:

  • EQ, NE

  • GT, LT, GE, LE

  • WILDCARD usando * e ?

  • EXISTS

  • Aninhado and, or e not

O servidor conectado valida os campos em relação aos metadados. Se uma consulta for rejeitada, atualize os metadados relevantes e reconstrua o filtro.