É possível usar o rastreio para monitorar e solucionar problemas em seu ambiente.
O rastreio deve ser fornecido para um servidor quando trabalhar com o suporte IBM®.
Sobre Esta Tarefa
Coletar rastreio pode ajudá-lo a monitorar e corrigir problemas em sua implementação do
WebSphere eXtreme
Scale.
A maneira como o rastreio é coletado
depende da sua configuração. Consulte
Opções de Rastreio para obter a lista das especificações de rastreio diferentes que podem ser coletadas.
Procedimento
- Colete o rastreio dentro de um ambiente WebSphere Application Server.
Se o seus servidores de catálogos e de contêiner estiverem em um ambiente WebSphere Application Server, consulte WebSphere Application Server: Trabalhando com Rastreio para obter mais informações.
- Colete o rastreio com o comando start do servidor de catálogos ou de contêiner independente.
É possível configurar o rastreio em um servidor de serviço de catálogo ou de contêiner usando os parâmetros
-traceSpec e
-traceFile com o comando
startOgServer. Por exemplo:
startOgServer.sh catalogServer -traceSpec ObjectGridPlacement=all=enabled -traceFile /home/user1/logs/trace.log
O parâmetro -traceFile é opcional. Se não configurar um local -traceFile, o arquivo de rastreio irá para o mesmo local dos arquivos de log do sistema.
Para obter mais informações sobre esses parâmetros, consulte ScriptstartOgServerScriptstartOgServer.
- Colete o rastreio no servidor de catálogos ou de contêiner independente com um arquivo de propriedades.
Para coletar rastreio a partir de um arquivo de propriedades, crie um arquivo, como server.properties, com o seguinte conteúdo:
workingDirectory=<directory>
traceSpec=<trace_specification>
systemStreamToFileEnabled=true
A propriedade
workingDirectory é o diretório-raiz para os logs e para o arquivo de rastreio opcional. Se o valor
workingDirectory não estiver configurado, o diretório de trabalho padrão será o local usado para iniciar os servidores, como
wxs_home/bin.
Para usar um arquivo de propriedades durante a inicialização do servidor, utilize o parâmetro
-serverProps com o comando
startOgServer e forneça o local do arquivo de propriedades do servidor.
Para obter mais informações sobre o arquivo de propriedades do servidor e como usar esse arquivo,
consulte Arquivo de Propriedades do Servidor.
- Colete o rastreio em um cliente independente.
É possível iniciar a coleção de rastreio em um cliente independente ao incluir propriedades do sistema no script de inicialização para o aplicativo cliente. No exemplo a seguir, as configurações de rastreio são especificadas para o aplicativo
com.ibm.samples.MyClientProgram:
java -DtraceSettingsFile=MyTraceSettings.properties
-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager
-Djava.util.logging.configureByServer=true com.ibm.samples.MyClientProgram
Consulte
WebSphere Application Server: Ativando Rastreio em Aplicativos Clientes e Independentes para obter mais informações.
- Colete o rastreio com a interface ObjectGridManager.
Também é possível configurar o rastreio durante o tempo de execução em uma interface
ObjectGridManager.
A configuração de um rastreio em uma interface
ObjectGridManager pode ser usada para
obter rastreio em um cliente
eXtreme Scale enquanto ele se conecta com um
eXtreme Scale e confirma as transações. Para configurar o rastreio em uma interface
ObjectGridManager,
forneça uma especificação de rastreio e um log de rastreio.
ObjectGridManager manager= ObjectGridManagerFactory.getObjectGridManager();
...
manager.setTraceEnabled(true);
manager.setTraceFileName("logs/myClient.log");
manager.setTraceSpecification("ObjectGridReplication=all=enabled");
Para obter mais informações sobre a interface ObjectGridManager,
consulte Interagindo com um ObjectGrid Usando a Interface ObjectGridManager.
- Colete o rastreio em servidores de contêiner com o utilitário xscmd.
Para coletar o rastreio com o utilitário
xscmd,
use o comando
-c setTraceSpec. Use o utilitário
xscmd
para coletar o rastreio em um ambiente independente durante o tempo de execução em vez de
durante a inicialização. É possível coletar o rastreio em todos os
servidores e serviços de catálogo ou filtrar os servidores com base no nome do
ObjectGrid, e em outras propriedades. Por exemplo, para coletar o rastreio ObjectGridReplication com acesso
ao servidor de serviço de catálogo, execute:
xscmd -c setTraceSpec "ObjectGridReplication=all=enabled"
Também é possível desativar o rastreio ao configurar a especificação de rastreio para
*=all=disabled..
Resultados
Os arquivos de rastreio são gravados no local especificado.