z/OS Logstreams

O z/OS System Logger fornece coleções de dados chamados logstreams, que são gravados em buffers de armazenamento local e, em seguida, em um recurso de acoplamento sysplex ou DASD para armazenamento de longo prazo. Os logstreams podem fornecer criação de log de alto desempenho para certos aplicativos.

Para obter informações gerais sobre os logstreams, leia z/OS Setting Up a Sysplex (SA22-7625).

O WebSphere Application Server for z/OS pode usar logstreams para os seguintes tipos de dados:
  • Dados no log de erros do WebSphere Application Server, os quais podem ser roteados para um logstream em vez de um conjunto de dados de impressão.
  • Dados nos logs de transações do WebSphere Application Server, os quais podem ser roteados para um logstream em vez de um conjunto de dados do Sistema de Arquivo Hierárquico (HFS)
  • Dados nos logs de recuperação do WebSphere Application Server Session Initiation Protocol (SIP), os quais são roteados para um logstream

Log de Erros do WebSphere Application Server

O log de erros do WebSphere Application Server é utilizado para registrar erro de tempo de execução detalhado e mensagens de status. Se a variável ras_log_logstreamName estiver definida, as mensagens de log de erros são gravadas no fluxo de logs denominado z/OS. Se a variável ras_log_logstreamName não estiver definida ou se o logstream denominado não existir, os registros de log de erros são gravados no STDERR.

A principal vantagem de enviar o log de erros do WebSphere Application Server for um logstream do z/OS é que você pode consolidar logs de erros de vários servidores e regiões servidoras. Se colocar o logstream de erro em um recurso de acoplamento, também pode consolidar os logs de erro a partir de diferentes sistemas no mesmo sysplex.

O WebSphere Application Server para z/OS fornece as seguintes tarefas de amostra para criar fluxos de logs de erro:
BBOERRLC
Criar um logstream de recurso de acoplamento para o log de erros do WebSphere Application Server
BBOERRLD
Criar um logstream de DASD apenas para o log de erros do WebSphere Application Server
Use o script copyZOS.sh para gravar estas tarefas em um conjunto de dados particionado.

Depois de criar o logstream, utilize o console administrativo ou de script para configurar a variável ras_log_logstreamName com o nome do logstream para todos os servidores cuja saída é para o logstream recentemente criado.

Use o script BBORBLOG no conjunto de dados de perfil SBBOEXEC para visualizar o log de erros. Leia o tópico Visualizando conteúdos do log de erro por meio do Log Browse Utility para obter informações adicionais.

Log do Parceiro XA de Transação

O log do parceiro XA de transação do WebSphere Application Server é utilizado para registrar as informações da transação (JTA). Essas informações são gravadas em um arquivo HFS ou um logstream z/OS, dependendo da configuração do arquivo de diretório da transação para um servidor específico:
  • Se o valor do diretório de transação for dir://directory_name, o diretório do sistema de arquivos nomeado será usado para armazenar informações da transação.
  • Se o valor do diretório da transação for logstream://logstream_name, as informações da transação são gravadas no logstream denominado.
O padrão é dir://app_server_root/tranlog/server_name.

Utilizando um logstream z/OS para o log de transações do WebSphere Application Server e colocando esse logstream em um recurso de acoplamento, você pode melhorar o desempenho por meio de operações de reinício por todo o sistema.

O WebSphere Application Server for z/OS fornece as seguintes tarefas de exemplo no conjunto de dados do produto SBBOJCL para criar logstreams de transação:
BBOTXALC
Criar um logstream de recurso de acoplamento para um log de transações do WebSphere Application Server
BBOTXALD
Criar um logstream de DASD apenas para um log de transações do WebSphere Application Server
Use o script copyZOS.sh para gravar estas tarefas em um conjunto de dados particionado.

Após criar o fluxo de logs, use o console administrativo para configurar um log de transações do servidor individual para logstream://logstream_name na guia de configuração das configurações do serviço de transações do servidor (Servidores > Tipos de Servidor > WebSphere Application Servers > server_name > Serviços do Contêiner > Serviço de Transações) e reinicie o servidor. Leia o tópico Configurações do serviço de transações para obter informações adicionais.

Nota: Quando um servidor de aplicativos é associado a uma célula do Network Deployment, você deve limpar todos os erros de transação existentes. Se o registro de transações estiver sendo feito em um fluxo de logs do z/OS, exclua o fluxo de logs de transação do servidor depois que o servidor de aplicativos for encerrado e recrie-o iniciando o servidor de aplicativos associado recentemente.

Criando Logstream de Recuperação SIP

Se a configuração de sua célula de implementação de rede inclui parceiros de replicação por diversos LPARs, os logstream de recuperação SIP precisam residir em um recurso de acoplamento. Os logstream de recuperação DASD podem ser usados somente se todos os parceiros de replicação estiverem no mesmo LPAR.

Os logstreams SIP precisam seguir um padrão muito específico em seus nomes: CELL_NAME.SERVER_NAME.D e CELL_NAME.SERVER_NAME.M.

É possível ter erros indicando que um logstream está completo ou corrompido. Nessa situação, pode precisar excluir e redefinir o logstream. Os exemplos a seguir mostram tarefas que podem ser usadas para executar estas ações:

Exclua o logstream:
//DEFLOGA  JOB MSGLEVEL=(1,1),MSGCLASS=H,NOTIFY=&SYSUID,REGION=0M 
//*                            
//LOGDEFN  EXEC PGM=IXCMIAPU,REGION=4M      
//SYSPRINT DD   SYSOUT=*       
//*                            
//SYSIN    DD   *              
     DATA TYPE(LOGR)           
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S000.M)   
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S000.D)   
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S001.M)   
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S001.D)
/* 
Recrie o logstream:
//DEFLOGA  JOB MSGLEVEL=(1,1),MSGCLASS=H,NOTIFY=&SYSUID,REGION=0M  
//*                                
//LOGDEFN  EXEC PGM=IXCMIAPU,REGION=4M             
//SYSPRINT DD   SYSOUT=*           
//*                                
//SYSIN    DD   *
     DATA TYPE(LOGR)
     DEFINE LOGSTREAM 
     NAME(WT0CELL.WT0S000.M)
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60)
     HIGHOFFLOAD(80)
     DEFINE LOGSTREAM
     NAME(WT0CELL.WT0S000.D)     
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60) 
     HIGHOFFLOAD(80)
     DEFINE LOGSTREAM
     NAME(WT0CELL.WT0S001.M)
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60) 
     HIGHOFFLOAD(80)
     DEFINE LOGSTREAM
     NAME(WT0CELL.WT0S001.D)
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60)    
     HIGHOFFLOAD(80)       
/*     
//

Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cins_logstrm
Nome do arquivo: cins_logstrm.html