O Vault Log Analyzer é uma ferramenta de linha de comando que simplifica o processo de análise de logs da API do Vault e do Vault Java SDK. Através de um conjunto simples de comandos, o Log Analyzer importa um lote de logs e gera um arquivo CSV de estatísticas agregadas. O arquivo CSV pode então ser processado em uma tabela dinâmica para fácil manipulação e fornecer uma visão holística do desempenho da API e do SDK do Vault.
A ferramenta Vault Log Analyzer é distribuída como um único arquivo JAR e não requer instalação. Basta navegar até o link abaixo e clicar no botão "Download". A partir daí, o arquivo jar pode ser executado a partir de um console de linha de comando.
Baixe o vault-log-analyzer-24.2.0.jar mais recente
Recomendamos a criação de um diretório local para arquivos relacionados ao Vault Log Analyzer. Isso pode ajudar a acompanhar as várias entradas e saídas.
java -jar vault-log-analyzer-24.2.0.jar -logtype API -action IMPORT
java -jar vault-log-analyzer-24.2.0.jar -logtype API -action ANALYZE
java -jar vault-log-analyzer-24.2.0.jar -logtype DEBUG -action ANALYZE
A estrutura básica de um comando usando o Vault Log Analyzer:
java -jar {jarFile} -logtype {logType} -action {actionName} -input {folderPath} -output {filePath}
Comando | Parâmetro | Exemplo | Descrição |
---|---|---|---|
-logtype | API | -logtype API | Configure o analisador para processar logs de API |
-Ação | IMPORTAR | -action IMPORT | Usado para importar um lote de logs de API |
ANALISAR | -action ANALYZE | Usado para analisar o arquivo .db gerado do comando -action IMPORT | |
DOWNLOAD | -action DOWNLOAD | Usado para baixar registros de uso de API de um Vault especificado | |
-entrada | {pasta de registros} | -input ./logs | Caminho opcional para o local dos arquivos de log ao usar o comando -action IMPORT . O padrão é "/logs" se nenhum diretório for fornecido |
{arquivo .db} | -input ./vault-log-analyzer.db | Caminho opcional para o local do arquivo .db ao usar o comando -action ANALYZE . O padrão é "vault-log-analyzer.db" na pasta onde o arquivo jar | |
-saída | {arquivo .db} | -output ./path/to/analyze.db | Caminho opcional para o arquivo .db gerado ao usar o comando -action IMPORT . O padrão é "vault-log-analyzer.db" na pasta onde o arquivo jar |
{arquivo .csv} | -output ./path/to/analyze.csv | Caminho opcional para o arquivo .csv gerado ao usar o comando -action ANALYZE . O padrão é "vault-log-analyzer-api-YYYYMMDD-{time}.csv" se não houver nome de arquivo | |
{pasta} | -output ./path/to/logs | Caminho opcional para salvar logs de uso da API ao usar o comando -action DOWNLOAD . O padrão é a pasta "/logs" se nenhum diretório for fornecido | |
-vaultid | {ID do cofre} | -vaultid 123456 | Parâmetro opcional para preencher a coluna "vault_id" no arquivo .csv exportado ao usar os comandos -action IMPORT/-action ANALYZE . O padrão é o Vault ID no nome do arquivo de log da API. |
-vaultDns | {DNS do cofre} | -vaultDns cholecap.veevavault.com | Vault de onde os logs serão baixados ao usar o comando -action DOWNLOAD |
-sessãoId | {ID da sessão} | -sessionId {session ID} | Para autenticação em um vault ao usar o comando -action DOWNLOAD |
-data de início | {AAAA-MM-DD} | -startDate 2023-02-04 | Para especificar uma data de início ao usar o comando -action DOWNLOAD |
-data final | {AAAA-MM-DD} | -endDate 2023-02-05 | Para especificar uma data de término ao usar o comando -action DOWNLOAD . A data de início é obrigatória se estiver usando uma data de término. O padrão é o dia atual se nenhuma data de término for fornecida |
java -jar vault-log-analyzer-24.2.0.jar -logtype API -action IMPORT -input ./path/to/logs -output ./path/to/analyze.db
java -jar vault-log-analyzer-24.2.0.jar -logtype API -action ANALYZE -input ./path/to/analyze.db -output ./path/to/output.csv
java -jar vault-log-analyzer-24.2.0.jar -logtype API -action DOWNLOAD -vaultDns cholecap.veevavault.com -sessionId {session ID} -startDate 2023-02-01 -endDate 2023-02-05
Comando | Parâmetro | Exemplo | Descrição |
---|---|---|---|
-logtype | DEPURAR | -logtype DEBUG | Configure o analisador para processar logs de depuração do SDK |
-Ação | ANALISAR | -action ANALYZE | Usado para analisar o conteúdo da pasta "/logs" |
-entrada | {pasta de registros} | -input ./path/to/logs | Caminho para o local dos arquivos de log. O padrão é "/logs" se nenhum diretório for fornecido |
-saída | {arquivo .csv} | -output ./path/to/output.csv | Caminho para o arquivo .csv gerado ao usar o comando -action ANALYZE . O padrão é "vault-log-analyzer-debug-YYYYMMDD-{time}.csv" se nenhum nome de arquivo for fornecido |
java -jar vault-log-analyzer-24.2.0.jar -logtype DEBUG -action ANALYZE -input ./path/to/logs -output ./path/to/output.csv
Comando | Parâmetro | Exemplo | Descrição |
---|---|---|---|
-logtype | TEMPO DE EXECUÇÃO | -logtype RUNTIME | Configure o analisador para processar logs de tempo de execução do SDK |
-Ação | DOWNLOAD | -action DOWNLOAD | Usado para baixar logs do SDK Runtime de um Vault especificado |
-vaultDns | {DNS do cofre} | -vaultDns cholecap.veevavault.com | Vault de onde os logs serão baixados ao usar o comando -action DOWNLOAD |
-sessãoId | {ID da sessão} | -sessionId {session ID} | Para autenticação em um vault ao usar o comando -action DOWNLOAD |
-data de início | {AAAA-MM-DD} | -startDate 2023-02-04 | Para especificar uma data de início ao usar o comando -action DOWNLOAD |
-data final | {AAAA-MM-DD} | -endDate 2023-02-05 | Para especificar uma data de término ao usar o comando -action DOWNLOAD . A data de início é obrigatória se estiver usando uma data de término. O padrão é o dia atual se nenhuma data de término for fornecida |
java -jar vault-log-analyzer-24.2.0.jar -logtype RUNTIME -action DOWNLOAD -vaultDns cholecap.veevavault.com -sessionId {session ID} -startDate 2023-02-01 -endDate 2023-02-05