Configurando HPEL com script wsadmin
É possível configurar a estrutura de log e rastreio do High Performance Extensible Logging (HPEL) utilizando o script wsadmin. Utilize os exemplos neste tópico como um guia para construir seus próprios scripts wsadmin.
Sobre Esta Tarefa
Variável | Descrição |
---|---|
myCell | O noem da célula |
myNode | O nome do host do nó |
myServer | O nome do servidor |
Procedimento
- Utilize o objeto AdminConfig para configurar HPEL.
As alterações que você faz utilizando o objeto AdminConfig entram em vigor na próxima vez que você iniciar o servidor.
- Altere a especificação de rastreio.
O exemplo a seguir mostra como alterar a especificação de rastreio para *=info:com.ibm.ws.classloader.*=all
HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/") AdminConfig.modify(HPELService, "[[startupTraceSpec *=info:com.ibm.ws.classloader.*=all]]") AdminConfig.save()
- Altere o tamanho do repositório de criação de log.
O exemplo a seguir mostra como configurar o HPEL para excluir automaticamente o conteúdo do log antigo do repositório de criação de log quando o tamanho do repositório atinge 65 MB. Especifique HPELTrace ou HPELTextLog em vez de HPELLog para alterar a configuração do repositório de rastreio HPEL ou log do texto HPEL.
HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/") HPELLog = AdminConfig.list("HPELLog", HPELService) AdminConfig.modify(HPELLog, "[[purgeMaxSize 65]]") AdminConfig.save()
- Altere o local do repositório de criação de log.
O exemplo a seguir mostra como alterar o nome de diretório do repositório de criação de log HPEL para /tmp/myDirectory. Especifique HPELTrace ou HPELTextLog em vez de HPELLog para alterar a configuração do repositório de rastreio HPEL ou log do texto HPEL.
HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/") HPELLog = AdminConfig.list("HPELLog", HPELService) AdminConfig.modify(HPELLog, "[[dataDirectory /tmp/myDirectory]]") AdminConfig.save()
- Desativar o buffer de registro de log.
O exemplo a seguir mostra como alterar o repositório de criação de log HPEL para não usar o buffer de registro de log. Especifique HPELTrace ou HPELTextLog em vez de HPELLog para alterar a configuração do repositório de rastreio HPEL ou log do texto HPEL.
HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/") HPELLog = AdminConfig.list("HPELLog", HPELService) AdminConfig.modify(HPELLog, "[[bufferingEnabled false]]") AdminConfig.save()
Boas Práticas: Ative o armazenamento em buffer do registro de log em quase todos os casos. Somente desative o buffer de registro de log quando seu servidor estiver falhando inesperadamente e não for possível gravar o conteúdo do buffer no disco antes de parar. bprac
- Inicie a composição de um novo arquivo de log cada dia
especificado no horário.
O exemplo ao seguir mostra como ativar o repositório de criação de log HPEL para iniciar um novo arquivo de log todo dia às 3pm. Especifique HPELTrace ou HPELTextLog em vez de HPELLog para alterar a configuração do repositório de rastreio HPEL ou log do texto HPEL.
HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/") HPELLog = AdminConfig.list("HPELLog", HPELService) AdminConfig.modify(HPELLog, "[[fileSwitchTime 15]]") AdminConfig.modify(HPELLog, "[[fileSwitchEnabled true]]") AdminConfig.save()
- Altere a ação de sem espaço para o repositório de criação de
log.
O exemplo a seguir mostra como alterar a ação de sem espaço para o repositório de criação de log HPEL. Especifique HPELTrace ou HPELTextLog em vez de HPELLog para alterar a configuração do repositório de rastreio HPEL ou log do texto HPEL.
HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/") HPELLog = AdminConfig.list("HPELLog", HPELService) AdminConfig.modify(HPELLog, "[[outOfSpaceAction PurgeOld]]") AdminConfig.save()
- Altere a especificação de rastreio.
- Utilize o objeto AdminControl para configurar HPEL. As alterações que você fizer utilizando o objeto AdminControl
entram em vigor imediatamente.
- Altere a especificação de rastreio.
O exemplo a seguir mostra como alterar a especificação de rastreio para *=info:com.ibm.ws.classloader.*=all
HPELControlMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELControlService,process=myServer,*') AdminControl.setAttribute(HPELControlMBean, "traceSpecification", "*=info:com.ibm.ws.classloader.*=all")
- Altere o tamanho do repositório de criação de log.
O exemplo a seguir mostra como configurar o HPEL para excluir automaticamente o conteúdo do log antigo do repositório de criação de log quando o tamanho do repositório atinge 65 MB. Especifique HPELTraceDataService ou HPELTextLogService em vez de HPELLogDataService para alterar a configuração do repositório de rastreio HPEL ou log de texto HPEL.
HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*') AdminControl.setAttribute(HPELLogDataMBean, "purgeMaxSize", "65")
- Altere o local do repositório de criação de log.
O exemplo a seguir mostra como alterar o nome de diretório do repositório de criação de log HPEL para /tmp/myDirectory. Especifique HPELTraceDataService ou HPELTextLogService em vez de HPELLogDataService para alterar a configuração do repositório de rastreio HPEL ou log de texto HPEL.
HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*') AdminControl.setAttribute(HPELLogDataMBean, "dataDirectory", "/tmp/myDirectory")
- Desativar o buffer de registro de log.
O exemplo a seguir mostra como alterar o repositório de criação de log HPEL para não usar o buffer de registro de log. Especifique HPELTraceDataService ou HPELTextLogService em vez de HPELLogDataService para alterar a configuração do repositório de rastreio HPEL ou log de texto HPEL.
HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*') AdminControl.setAttribute(HPELLogDataMBean, "bufferingEnabled", "false")
Boas Práticas: Ative o armazenamento em buffer do registro de log em quase todos os casos. Somente desative o buffer de registro de log quando seu servidor estiver falhando inesperadamente e não for possível gravar o conteúdo do buffer no disco antes de parar. bprac
- Inicie a composição de um novo arquivo de log cada dia
especificado no horário.
O exemplo ao seguir mostra como ativar o repositório de criação de log HPEL para iniciar um novo arquivo de log todo dia às 3pm. Especifique HPELTrace ou HPELTextLog em vez de HPELLog para alterar a configuração do repositório de rastreio HPEL ou log do texto HPEL.
HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*') AdminControl.setAttribute(HPELLogDataMBean, "fileSwitchTime", "15") AdminControl.setAttribute(HPELLogDataMBean, "fileSwitchEnabled", "true")
- Altere a ação de sem espaço para o repositório de criação de
log.
O exemplo a seguir mostra como alterar a ação de sem espaço para o repositório de criação de log HPEL. Especifique HPELTraceDataService ou HPELTextLogService em vez de HPELLogDataService para alterar a configuração do repositório de rastreio HPEL ou log de texto HPEL.
HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*') AdminControl.setAttribute(HPELLogDataMBean, "outOfSpaceAction", "PurgeOld")
- Altere a especificação de rastreio.
Resultados


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_confHPELwsadmin
Nome do arquivo: ttrb_confHPELwsadmin.html