Introdução #
O Open iT suporta relatórios de utilização ALM, recolhendo ficheiros de registo e convertendo-os para o formato Open iT.
Um cliente Open iT está instalado no servidor de licenças e o servidor de licenças não cria registos de histórico de utilização de licenças para esta recolha. O coletor de dados inicia o coletor de dados brutos para solicitar os logs do histórico de uso da licença ao gerenciador de licenças a cada 5 minutos, acionando o processo de coleta de dados. Assim que os registos são recebidos, o coletor de dados br utos transmite-os ao coletor de dados. Os dados recolhidos são então enviados para um pré-processador de dados para processamento. Após o pré-processamento, os dados finais pré-processados são enviados e armazenados no Core Server.
Fluxo de trabalho de análise de ficheiros de registo com o Raw Collector
Isto produzirá os seguintes tipos de dados agregados utilizados para relatórios históricos:
Registar dados de registo:
- (89) Total de licenças de utilização Eventos de licença
- (90) Licença individual de utilização Eventos de licença
- (91) Grupo de utilizadores Licença Utilização Eventos de licença
- (108) Licença de anfitrião Utilizar eventos de licença
- (109) Grupo de acolhimento Licença de utilização Eventos de licença
Dados do registo de eventos:
- (104) Eventos do ficheiro de registo de licenças v2.0
- (107) Licença recusada Utilização de licença Eventos de licença
As secções seguintes guiá-lo-ão na definição da configuração necessária para recolher e enviar os dados necessários para o servidor.
Aplicar as configurações apresentadas no cliente Open iT.
Requisitos #
- Um Open iT Client ligado a um Open iT Server ou a uma configuração Open iT coexistente
- Direitos administrativos do servidor de licenças
- Caminho completo para o ficheiro de registo de depuração
Ativar a recolha de dados de registo #
Estes são os passos necessários para ativar a recolha de dados de registo ALM.
- Abra uma linha de comandos com privilégios de administrador.
- Vá para o diretório bin, que por padrão está em C:\Program Files\OpeniT\Core\bin, execute o comando:
Sintaxe do comando
cd $BIN_DIR
Exemplo
cd C:\Arquivos de Programas\OpeniT\Core\bin
- Uma vez no diretório, ativar a recolha de dados de registo ALM, executar o comando:
Sintaxe do comando
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.general.active=true"
- Definir o caminho para a base de dados produzida pelo ALM, executar o comando:
Sintaxe do comando
openit_oconfinit -u “collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.operations.arguments=automationlm –databasefile \”<database_file>\” –outputfile \”${OpeniT.directories.temp}/SqlCeUtil/ALM/automationlm.csv\” –logdir \”${OpeniT.directories.log}\””
where <database_file> is the path to the database produced by ALM. This is usually in C:\ProgramData\Siemens\Automation\Automation License Manager\logging.
Exemplo
openit_oconfinit -u “collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.operations.arguments=automationlm –databasefile \”C:\ProgramData\Siemens\Automation\Automation License Manager\logging\almdb.sdf\” –outputfile \”${OpeniT.directories.temp}/SqlCeUtil/ALM/automationlm.csv\” –logdir \”${OpeniT.directories.log}\””
Configuração avançada #
| Nome do atributo | Valor aceite | Descrição |
| instâncias máximas | Uint (por exemplo, 5, 8, 9) | O número de instâncias que podem ser executadas ao mesmo tempo. |
| tratamento máximo | Cadeia de caracteres (end-oldest, end-all-old, ou end-new) | A ação realizada quando é atingido o número máximo de instâncias: end-oldest - Especifique esta opção para parar/encerrar a instância mais antiga e iniciar uma nova. end-all-old - Especifique esta opção para parar/encerrar todas as instâncias em execução antes de iniciar a nova. end-new - Especifique esta opção para impedir o início de uma nova instância. |
| fim do prazo | Período de tempo (por exemplo, P30S, P5M, P1H) | O tempo máximo de espera antes de terminar uma instância em execução. |
| quarentena | Período de tempo (por exemplo, P30S, P5M, P1H) | O tempo de espera antes de iniciar uma nova instância após uma anterior. |
Configurar a recolha de ficheiros de registo #
O arquivo de configuração do arquivo de log do ALM, logfilecollector-alm.xml, é encontrado no diretório Components, que está, por padrão, em C:\Program Files\OpeniT\Core\Configuration\Components. Não é necessário atualizá-lo, mas se quiser saber mais sobre seu comportamento, consulte a tabela Configuração do analisador de logs do ALM.
| Nome do objeto | Valor aceite | Descrição |
| fonte.dir | DirName (ou seja, ${OpeniT.diretories.temp}/SqlCeUtil/ALM/) | Localização dos ficheiros de registo ALM. |
| fonte.padrão | Cadeia de caracteres (ou seja, *.csv) | O padrão glob que identifica os ficheiros fonte no diretório fonte. |
| fonte.visto | Cadeia de caracteres (recolher, ignorar ou rejeitar) | Os ficheiros vistos são os ficheiros de origem anteriormente recolhidos. collect - Especifique esta opção para recolher desde o início de cada vez. ignore - Especifique esta opção para saltar a recolha do mesmo ficheiro novamente. tail - Especifique esta opção para continuar a recolha desde o fim do ficheiro da última vez (ou seja, recolher os ficheiros adicionados desde a última vez). |
| fonte.cmplines | Número inteiro (por exemplo, 6, 10, 20) | Isto é necessário se o valor de source.seen for tail. Este é o número de linhas comparado com os ficheiros de origem recolhidos anteriormente para determinar onde iniciar a recolha. Nota: Se este número for demasiado baixo, pode acabar com uma posição incorrecta e podem existir dados duplicados nos ficheiros de registo. Normalmente, é melhor ter algumas linhas a mais do que o estritamente necessário do que uma única linha a menos. |
| destino.dir | DirName (ou seja, ${OpeniT.diretories.temp}/LogFileCollector) | Esta é a localização do diretório que contém os dados de registo recolhidos. |
| módulo de destino | Cadeia de caracteres (ou seja, licença) | O tipo de módulo de destino (em geral). |
| target.datatype | Cadeia de caracteres (ou seja, alm) | O tipo específico de dados de destino. |
| alvo.intervalo | Período de tempo (por exemplo, P30S, P5M, P1D) | O intervalo de tempo entre as execuções do coletor. |
| target.rotation-size | Número inteiro (por exemplo, 6, 10, 20) | O ficheiro de registo roda se ultrapassar o número (em mb) definido. |
| target.rotation-glob | Cadeia de caracteres (por exemplo, *) | O padrão glob a corresponder antes de o ficheiro de registo rodar. |
Configuração do analisador de registos ALM
Desativar a recolha de dados do registo #
A ativação da recolha de dados de registo agrega automaticamente os dados de registo e de registo de eventos. Se pretender recolher apenas dados do registo de eventos, siga estes passos.
- Abra uma linha de comandos com privilégios de administrador.
- Vá para o diretório bin, que por padrão está em C:\Program Files\OpeniT\Core\bin, execute o comando:
Sintaxe do comando
cd $BIN_DIR
Exemplo
cd C:\Arquivos de Programas\OpeniT\Core\bin
- Uma vez no diretório, desactive a recolha de dados de registo e execute o comando:
Sintaxe do comando
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.preprocess_alm_licenselogs-records.general.active=false"
- Alterar o tratamento dos registos de eventos, executar o comando:
Sintaxe do comando
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.preprocess_alm_licenselogs-events.operations.arguments=-srcdir \"${OpeniT.diretories.temp}/LogFileCollector\" -srcpattern raw-alm-license-LogFileCollector*.data -srcfilehandling rename -trgdir \"${OpeniT.diretories.temp}/LogParserALM\" -module license -datatype event -resolution PT1H -matchobjects \"${OpeniT.diretories.conf}/matchobjects-event-alm.oconf\" -type event -disable-statlogging"
- Alterar o calendário de transferência de dados, executar o comando:
Sintaxe do comando
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.transfer_alm_licenselogs.scheduling.start-triggers.trigger#1.job-name=preprocess_alm_licenselogs-events"
Verificar a recolha de dados de registo #
Após a ativação, pode verificar se os dados são recolhidos e enviados para o servidor, seguindo estes passos:
- Abra uma linha de comandos com privilégios de administrador.
- Vá para o diretório bin, que por padrão está em C:\Program Files\OpeniT\Core\bin, execute o comando:
Sintaxe do comando
cd $BIN_DIR
Exemplo
cd C:\Arquivos de Programas\OpeniT\Core\bin
- Executar o comando:
Sintaxe do comando
openit_executor -r collect_license_alm-logs
- Verifique se existem ficheiros archiver*.in criados no servidor no diretório do arquivador, que, por predefinição, se encontra em C:\ProgramData\OpeniT\Data\incoming\archiver.
