Parâmetros de probe SNMP
Esta lista de parâmetros pode ser passada para as probes SNMP.
Para obter instruções sobre como configurar parâmetros de probe, consulte Definir parâmetros de probe.
| Parâmetro | Descrição | Valor Padrão | ||||||
|---|---|---|---|---|---|---|---|---|
| oid_spec_list | Uma lista de especificações OID, uma por linha. Cada especificação deve estar em um dos dois formulários a seguir:
{OID secundários} refere-se a uma lista delimitada por vírgulas de nós secundários nas entradas da tabela fornecida. Por exemplo, "ifEntry.ifIndex,ifEntry.ifDescr,ifEntry.ifType" são OID secundários da tabela "iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable". Por conveniência, o prefixo de entrada da tabela pode ser omitido. (Os secundários anteriores podem ser especificados como "ifIndex,ifDescr,ifType".) Qualquer secundário pode incluir um qualificador de filtro entre parênteses. Por exemplo, o secundário "entPhysicalContainedIn(=0)" especifica o retorno de entradas de tabela somente se o valor de "entPhysicalContainedIn" for igual a 0. Os operadores compatíveis com a expressão são:
Se mais de um secundário tiver uma expressão de filtro, uma correspondência em qualquer um dos secundários fará com que essa entrada seja lida. Qualquer conteúdo incluindo e após um "//" é ignorado (comentários). Qualquer OID que não comece com "1.3.6.1" ou "iso.org.dod.internet" é precedido automaticamente por "1.3.6.1". como uma conveniência. |
obrigatório | ||||||
| origem | O endereço IP ou o nome do host do dispositivo para consultar o SNMP. | obrigatório | ||||||
| índice | O índice a ser aplicado após a cadeia de caracteres da comunidade, para indexação de cadeia de caracteres da comunidade no estilo Cisco (para interrogação de VLAN). | 0 | ||||||
| credential_id | O sys_id de uma credencial específica que é preferencial para uso acima do restante. Este parâmetro é somente para uso interno e não é compatível. | nenhuma | ||||||
| credential_tag | O marcador de credencial que deve ser usado. Este parâmetro é somente para uso interno e não é compatível. | nenhuma | ||||||
| tempo limite | O valor de tempo limite (em milissegundos) para aguardar uma resposta, em vez do padrão. Você pode usar este parâmetro para substituir o mid.snmp.request.timeout parâmetro de configuração do SNMP MID Server. Nota: Quando use_getbulk é definido como true, o valor de tempo limite é para uma solicitação GETBULK individual. |
1500 | ||||||
| estabelecido_session_timeout | O intervalo (em milissegundos) para aguardar uma resposta depois que pelo menos uma resposta foi recebida. Valores mais longos podem ser úteis para coletar dados completos e precisos. Você pode usar este parâmetro para substituir o mid.snmp.session.timeout parâmetro de configuração do SNMP MID Server. | 500 | ||||||
| depurar | Habilita o registro em log de depuração. Defina como verdadeiro para o modo de depuração. | falso | ||||||
| request_interval | O intervalo (em milissegundos) entre solicitações sucessivas de um OID quando uma resposta não foi recebida, até que o valor de tempo limite (ou estabelecido_session_timeout) seja atingido. Se este valor estiver definido como pelo menos enquanto o valor de tempo limite (ou estabelecido_session_timeout), somente uma única solicitação será enviada para qualquer OID específico. Se você alterar o valor de tempo limite (ou estabelecido_session_timeout), ajuste o request_interval ao mesmo tempo para evitar o envio de muitas ou poucas solicitações para o mesmo OID, conforme apropriado para um determinado ambiente. | 400 | ||||||
| request_delay | O intervalo (em milissegundos) entre o recebimento de uma resposta e a transmissão da próxima solicitação. O padrão é 0 (sem atraso). Este valor pode ser definido para diminuir a taxa geral de uma consulta SNMP. | 0 | ||||||
| formato_resultado | Retorna cargas no formato JSON para estas probes:
Aviso: O uso deste parâmetro com quaisquer outras probes faz com que o sensor falhe. |
JSON | ||||||
| use_getbulk | Habilita o uso de solicitações SNMP GETBULK para recuperar dados tabulares de dispositivos SNMP em vez de usar várias solicitações SNMP GETNEXT. Para dados tabulares, GETBULK é mais eficiente. Independentemente do tipo de solicitação, determinados dispositivos podem não retornar resultados quando estão ocupados com outras tarefas. Este parâmetro é usado para configurar no nível da probe. GETBULK também pode ser definido para um MID Server individual ou globalmente para todos os MID Servers. As configurações são listadas na ordem de precedência:
Os parâmetros established_session_timeout, request_interval, e request_delay são ignorados quando use_getbulk está definido como verdadeiro. Em vez disso, o parâmetro retries está disponível. A configuração de tempo limite é a mesma usada por use_getscalar. Por padrão, os seguintes probes usam solicitações GETBULK (o valor do parâmetro é true).
Nota: Essas probes têm um valor timeout de 5000. |
falso | ||||||
| usar_getscalar | Permite o uso de recuperação e manipulação simplificadas de valores escalares de dispositivos SNMP. Os parâmetros established_session_timeout, request_intervale request_delay são ignorados quando use_getscalar está definido como verdadeiro. Em vez disso, os parâmetros retries e timeout estão disponíveis. A configuração de tempo limite é a mesma usada por use_getbulk. |
falso | ||||||
| novas tentativas | O número de tentativas adicionais que Descoberta faz para concluir uma solicitação GETBULK individual (consulte use_getbulk) ou uma solicitação GETNEXT quando o parâmetro use_getscalar está definido como verdadeiro. | 2 |