Verificações e políticas padrão do monitoramento de verificação de diretório

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 9 min. de leitura

    • O Agent Client Collector fornece as seguintes verificações e políticas padrão para monitoramento de verificação de diretório.

    Tabela 1. Windows Eventos do SO - Política estendida
    Tipo Verificação Descrição Uso e exemplo de uso Saída
    Evento verificar-diretório-contagem-de-arquivos
    Verifica o número de arquivos presentes em um determinado diretório e o compara com o aviso fornecido e os limites críticos. Retorna um evento CRÍTICO, AVISO ou OK com base nos limites crítico e de aviso.
    Nota:
    • Conta o número de arquivos dentro do diretório, sem incluir arquivos em subdiretórios.
    • O agente requer permissões de leitura e execução no diretório que está sendo monitorado.

    check-directory-file-count.rb (opções)

    -d, --dir Caminho absoluto para o diretório para contar os arquivos (obrigatório)

    -w, --warning Limite de aviso (obrigatório)

    -c, --critical Limite crítico (obrigatório)

    -H, include_hidden_files Defina ativo como verdadeiro para incluir arquivos ocultos durante a contagem (o padrão é falso)

    Exemplo de uso:

    check-directory-file-count.rb -d /path/to/directory -w 50 -c 100

    DirectoryFileCount CRÍTICO:<path to dir> tem 165 arquivos.
    Evento verificar-diretório-integridade
    Compara a hora da última modificação do diretório com a hora atual para determinar se ocorreram atualizações dentro de um intervalo de tempo definido. Com base nessa comparação, a verificação retorna um evento CRÍTICO ou OK.
    Nota:
    O agente requer permissões de leitura e execução no diretório que está sendo monitorado.

    verificações comuns check-directory-integrity (opções)

    -d, --dirpath DIRPATH: caminho absoluto para o diretório a ser verificado (obrigatório).

    -i, --interval INTERVAL: intervalo de tempo em segundos para verificar se há atualizações recentes (obrigatório). O valor padrão pode ser definido como 180 segundos.

    Exemplo de uso:

    verificações comuns check-directory-update -d /path/to/directory -i 180

    		 Verificações comuns CRÍTICAS: integridade de diretório: MUDANÇAS DETECTADAS para<path to file> nos últimos 180 segundos (Última modificação: Wed, 04 Dec 2024 12:18:55 EST).
    Evento verificar-arquivo-idade

    Avalia a idade de um arquivo especificado comparando a hora da última modificação com a hora atual. Gera um alerta se o arquivo exceder os limites de idade críticos ou de aviso definidos.

    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 commonchecks check-file-age (opções)

    -f, --filepath FILEPATH: caminho absoluto para o arquivo a ser verificado (obrigatório).

    -c, --critical CRÍTICO: limite de idade crítico em minutos para o arquivo (obrigatório).

    -w, --warning AVISO: limite de idade de aviso em minutos para o arquivo (obrigatório).

    Exemplo de uso:commonchecks check-file-age -f /path/to/file.txt -c 120 -w 60

    		 Verificações comuns OK: arquivo<path to file> idade: 30 minutos.
    Evento verificar-arquivo-tempo-de-resposta
    Compara o tempo necessário para ler um arquivo especificado e o compara com os limites críticos e de aviso. Com base nessa comparação, a verificação retorna um evento CRÍTICO ou OK.
    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 verificações comuns check-file-response-time (opções)

    -f, --filepath FILEPATH: caminho absoluto para o arquivo a ser verificado (obrigatório).

    -c, --critical CRÍTICO: limite crítico em segundos para o tempo de resposta do arquivo (obrigatório).

    -w, --warning AVISO: limite de aviso em segundos para o tempo de resposta do arquivo (obrigatório).

    -t, --timeout TIMEOUT: tempo máximo permitido para ler o conteúdo do arquivo, especificado em segundos. O valor de tempo limite deve ser maior que o valor do limite crítico.

    Exemplo de uso:commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

    		 Verificações comuns OK: Tempo de resposta de leitura de arquivo: 0.0020 segundos para file_name: /var/log/servicenow/agent-client-collector/acc.log.
    Evento verificar-tamanho-do-arquivo

    Mede o tamanho de um arquivo (a quantidade real de dados que ele contém) e o compara com os limites especificados. Retorna um evento CRÍTICO, AVISO ou OK com base na comparação do tamanho do arquivo e dos limites.

    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 verificações comuns verificar tamanho do arquivo (opções)

    -f, --filepath FILEPATH Caminho absoluto para o arquivo necessário (obrigatório).

    -c, --critical CRÍTICO. Limite crítico em kilobytes. Forneça como um número sem unidades (por exemplo, 1000 para 1000 KB) (obrigatório)

    -w, --warning AVISO. Limite de aviso em kilobytes. Forneça como um número sem unidades (por exemplo, 500 para 500 KB) (obrigatório)

    Exemplo de uso:verificaçõescomuns check-file-size -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

    		 Verificações comuns OK: para arquivo<path to file> tamanho: 4,72 KB está dentro dos limites
    Evento verificar-espaço-do-arquivo

    Mede o tamanho de um arquivo no disco em relação aos limites especificados, retornando um evento CRÍTICO, AVISO ou OK com base nos limites.

    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 commonchecks check-file-space (opções)

    -f, --filepath FILEPATH: caminho absoluto para o arquivo relevante (obrigatório).

    -c, --critical CRÍTICO: limite crítico em kilobytes. Fornecido como um número sem unidades (por exemplo, 1000 para 1000 KB) (obrigatório)

    -w, --warning AVISO: limite de aviso em kilobytes. Fornecido como um número sem unidades (por exemplo, 500 para 500 KB) (obrigatório)

    -b, --blocksize BLOCKSIZE: tamanho do bloco em bytes (padrão = 4096) (obrigatório)

    Exemplo de uso:

    verificações comuns check-file-space -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml    		 Verificações comuns OK: arquivo<path to file> espaço: 8,00 KB está dentro do limite
    Evento os.windows.check-directory-space Verifica o espaço em disco ocupado pelo conteúdo de um diretório. Retorna um evento CRÍTICO, AVISO ou OK, com base na comparação com os limites de severidade de evento crítico e de aviso fornecidos.
    Nota:
    O agente requer permissões de leitura e execução no diretório que está sendo monitorado.
    		 winchecks check-dir-space (opções)

    -d, --dirpath DIRPATH: caminho absoluto para o diretório que está sendo verificado (obrigatório).

    -c, --critical CRÍTICO: limite de espaço em disco crítico em kilobytes (obrigatório).

    -w, --warning AVISO: aviso de limite de espaço em disco em kilobytes (obrigatório).

    -t, --timeout TIMEOUT: tempo máximo permitido para o cálculo do tamanho do diretório, especificado em segundos (obrigatório).

    Exemplo de uso:winchecks check-dir-space -d /path/to/directory -c 1000 -w 500 -t 120

    		 O Windows verifica OK: diretório<path to file> espaço: 369,25 KB está dentro dos limites
    Tabela 2. Linux Eventos do SO - Política estendida
    Tipo Verificação Descrição Uso e exemplo de uso Saída
    Evento verificar-diretório-contagem-de-arquivos
    Verifica o número de arquivos presentes em um determinado diretório e o compara com o aviso fornecido e os limites críticos. Retorna um evento CRÍTICO, AVISO ou OK com base nos limites crítico e de aviso.
    Nota:
    • Conta o número de arquivos dentro do diretório, sem incluir arquivos em subdiretórios.
    • O agente requer permissões de leitura e execução no diretório que está sendo monitorado.

    check-directory-file-count.rb (opções)

    -d, --dir Caminho absoluto para o diretório para contar os arquivos (obrigatório)

    -w, --warning Limite de aviso (obrigatório)

    -c, --critical Limite crítico (obrigatório)

    -H, include_hidden_files Defina ativo como verdadeiro para incluir arquivos ocultos durante a contagem (o padrão é falso)

    Exemplo de uso:

    check-directory-file-count.rb -d /path/to/directory -w 50 -c 100

    DirectoryFileCount CRÍTICO:<path to dir> tem 165 arquivos.
    Evento verificar-diretório-integridade
    Compara a hora da última modificação do diretório com a hora atual para determinar se ocorreram atualizações dentro de um intervalo de tempo definido. Com base nessa comparação, a verificação retorna um evento CRÍTICO ou OK.
    Nota:
    O agente requer permissões de leitura e execução no diretório que está sendo monitorado.

    verificações comuns check-directory-integrity (opções)

    -d, --dirpath DIRPATH: caminho absoluto para o diretório a ser verificado (obrigatório).

    -i, --interval INTERVAL: intervalo de tempo em segundos para verificar se há atualizações recentes (obrigatório). O valor padrão pode ser definido como 180 segundos.

    Exemplo de uso:

    verificações comuns check-directory-update -d /path/to/directory -i 180

    		 Verificações comuns CRÍTICAS: integridade de diretório: MUDANÇAS DETECTADAS para<path to file> nos últimos 180 segundos (Última modificação: Wed, 04 Dec 2024 12:18:55 EST).
    Evento verificar-arquivo-idade

    Avalia a idade de um arquivo especificado comparando a hora da última modificação com a hora atual. Gera um alerta se o arquivo exceder os limites de idade críticos ou de aviso definidos.

    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 commonchecks check-file-age (opções)

    -f, --filepath FILEPATH: caminho absoluto para o arquivo a ser verificado (obrigatório).

    -c, --critical CRÍTICO: limite de idade crítico em minutos para o arquivo (obrigatório).

    -w, --warning AVISO: limite de idade de aviso em minutos para o arquivo (obrigatório).

    Exemplo de uso:commonchecks check-file-age -f /path/to/file.txt -c 120 -w 60

    		 Verificações comuns OK: arquivo<path to file> idade: 30 minutos.
    Evento verificar-arquivo-tempo-de-resposta
    Compara o tempo necessário para ler um arquivo especificado e o compara com os limites críticos e de aviso. Com base nessa comparação, a verificação retorna um evento CRÍTICO ou OK.
    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 verificações comuns check-file-response-time (opções)

    -f, --filepath FILEPATH: caminho absoluto para o arquivo a ser verificado (obrigatório).

    -c, --critical CRÍTICO: limite crítico em segundos para o tempo de resposta do arquivo (obrigatório).

    -w, --warning AVISO: limite de aviso em segundos para o tempo de resposta do arquivo (obrigatório).

    -t, --timeout TIMEOUT: tempo máximo permitido para ler o conteúdo do arquivo, especificado em segundos. O valor de tempo limite deve ser maior que o valor do limite crítico.

    Exemplo de uso:commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

    		 Verificações comuns OK: Tempo de resposta de leitura de arquivo: 0.0020 segundos para file_name: /var/log/servicenow/agent-client-collector/acc.log.
    Evento verificar-tamanho-do-arquivo

    Mede o tamanho de um arquivo (a quantidade real de dados que ele contém) e o compara com os limites especificados. Retorna um evento CRÍTICO, AVISO ou OK com base na comparação do tamanho do arquivo e dos limites.

    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 verificações comuns verificar tamanho do arquivo (opções)

    -f, --filepath FILEPATH Caminho absoluto para o arquivo necessário (obrigatório).

    -c, --critical CRÍTICO. Limite crítico em kilobytes. Forneça como um número sem unidades (por exemplo, 1000 para 1000 KB) (obrigatório)

    -w, --warning AVISO. Limite de aviso em kilobytes. Forneça como um número sem unidades (por exemplo, 500 para 500 KB) (obrigatório)

    Exemplo de uso:verificaçõescomuns check-file-size -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

    		 Verificações comuns OK: para arquivo<path to file> tamanho: 4,72 KB está dentro dos limites
    Evento verificar-espaço-do-arquivo

    Mede o tamanho de um arquivo no disco em relação aos limites especificados, retornando um evento CRÍTICO, AVISO ou OK com base nos limites.

    Nota:
    O agente requer permissões de leitura e execução no arquivo que está sendo monitorado.
    		 commonchecks check-file-space (opções)

    -f, --filepath FILEPATH: caminho absoluto para o arquivo relevante (obrigatório).

    -c, --critical CRÍTICO: limite crítico em kilobytes. Fornecido como um número sem unidades (por exemplo, 1000 para 1000 KB) (obrigatório)

    -w, --warning AVISO: limite de aviso em kilobytes. Fornecido como um número sem unidades (por exemplo, 500 para 500 KB) (obrigatório)

    -b, --blocksize BLOCKSIZE: tamanho do bloco em bytes (padrão = 4096) (obrigatório)

    Exemplo de uso:

    verificações comuns check-file-space -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml    		 Verificações comuns OK: arquivo<path to file> espaço: 8,00 KB está dentro do limite
    Evento os.linux.check-directory-size Verifica o espaço alocado para o diretório de um disco e o compara com os limites críticos e de aviso especificados.
    Nota:
    O agente requer permissões de leitura e execução no diretório que está sendo monitorado.
    		 linuxchecks check-directory-size (opções)

    -d, --dirpath DIRPATH: caminho absoluto para o diretório que está sendo verificado (obrigatório).

    -c, --critical CRÍTICO: limite de espaço em disco crítico em kilobytes (obrigatório).

    -w, --warning AVISO: aviso de limite de espaço em disco em kilobytes (obrigatório).

    -t, --timeout TIMEOUT: tempo máximo permitido para o cálculo do tamanho do diretório, especificado em segundos (obrigatório).

    Exemplo de uso:linuxchecks check-directory-size -d path/to/directory -c 100 -w 50 -t 30

    		 Verificações do Linux CRÍTICAS: Diretório<path to file> tamanho: 500,00 KB excede o limite crítico de 10,00 KB
    Evento os.linux.check-directory-space Verifica o espaço em disco ocupado pelo conteúdo do diretório. Retorna um evento CRÍTICO, AVISO ou OK com base na comparação com os limites crítico e de aviso.
    Nota:
    O agente requer permissões de leitura e execução no diretório que está sendo monitorado.
    		 linuxchecks check-directory-space (opções)

    -d, --dirpath DIRPATH: caminho absoluto para o diretório que está sendo verificado (obrigatório).

    -c, --critical CRÍTICO: limite de espaço em disco crítico em kilobytes (obrigatório).

    -w, --warning AVISO: aviso de limite de espaço em disco em kilobytes (obrigatório).

    -t, --timeout TIMEOUT: tempo máximo permitido para o cálculo do tamanho do diretório, especificado em segundos (obrigatório).

    Exemplo de uso:linuxchecks check-directory-space -d /path/to/directory -c 10 -w 5 -t 30

    		 Verificações do Linux CRÍTICAS: Diretório<path to file> espaço: 374,00 KB excede o limite crítico de 10,00 KB