Logging e alertas
Consulte também
O mecanismo de serviço Sun BPEL fornece a habilidade de rastrear valores de mensagem ou expressão durante a execução do processo. O recurso Logging e alertas usa o mecanismo de extensão padrão WS-BPEL. O recurso Logging e alertas tem suporte para quase todas as atividades BPEL.
O IDE oferece a habilidade de definir logging e alertas para as atividades do processo. O logging é usado para escrever valores especificados de expressão ou informações de referência de ponto final de links de parceiros no log do servidor. Os alertas permitem receber um alerta com essas informações. Após ajustar as condições de logging ou alertas e o processo BPEL ser executado, os valores especificados de expressão são escritos no arquivo de log do servidor ou um alerta é enviado ao usuário, dependendo do nível do log.
O recurso Logging e alertas é definido no mapeador de Logging. O mapeador de Logging está disponível como uma aba na visualização Design ou Código-fonte do processo BPEL. O mapeador de Logging consiste nos seguintes componentes:
- Painel da árvore de origem. O painel da árvore de origem está posicionado no lado esquerdo e contém um componente árvore que fornece acesso a variáveis de dados do processo comercial e links de parceiros. Aqui um usuário pode selecionar a variável a ser seguida.
- Barra de menu. A barra de menu fornece os operadores, os elementos necessários e as funções XPath usadas para criar os mapeamentos. A utilização das funções é muito similar àquela no Mapeador BPEL.
- Painel de mapeamento. O painel de mapeamento contém uma tela para a criação de mapeamentos. Ao selecionar uma função na barra de menu, é exibida uma caixa de função no painel de mapeamento. Se a função aceitar quaisquer argumentos, então o lado esquerdo da caixa de função possuirá um conector para cada argumento. Se um argumento for opcional, então será mostrado um ponto de interrogação depois do nome do argumento. O lado direito da caixa de função possui um conector para o resultado.
- Painel da árvore de destino. O painel da árvore de destino está posicionado no lado direito e habilita o usuário a escolher quando o log de log será feito e o nível de logging.
Definindo logging
Ao definir logging para uma atividade, você pode rastrear o valor dos seguintes componentes:
Nos mapeamentos você pode usar uma ou mais funções XPath da barra de menu.
Para registrar o valor da variável:
- No diagrama, selecione uma atividade. O logging será realizado em conexão com a execução da atividade.
- Vá para a aba Logging do editor BPEL. O mapeador de Logging é aberto.
Você também pode abrir o mapeador de Logging clicando com o botão direito do mouse na atividade e selecionando Ir para > Logging (Alt-L).
- No painel da árvore de origem, expanda a árvore de variáveis até que a variável a ser rastreada fique visível.
- No painel da árvore de destino, expanda o nó da atividade. Os nós que designam o momento do logging tornam-se visíveis.
- Escolha quando a entrada do logging deve ser feita e expanda o nó apropriado:
- LOG_onStart. O valor da variável é gravado no log quando a atividade é iniciada.
- LOG_onComplete. O valor da variável é gravado no log quando a execução da atividade é concluída.
- Defina o nível de logging. Arraste a conexão a partir da variável a ser rastreada para o nó apropriado no painel da árvore de destino. Os seguintes níveis de logging estão disponíveis:
- Grave
- Aviso
- Informações
- Configuração
- Refinado
- Mais refinado
- O mais refinado
Na visualização Design, um pequeno ícone é exibido ao lado da atividade com logging definido nele. Clicando no ícone você pode alternar para o mapeador de Logging.
A entrada no log será feita somente se o nível do log definido para a variável corresponder ao nível de log especificado para o BPEL SE no servidor de aplicativo.
Para ajustar o nível de log para BPEL SE:
Para especificar o nível de log para o BPEL SE, é usado o console Admin do servidor de aplicativo.
- Na janela Serviços, expanda o nó Servidores. Certifique-se de que o servidor de aplicação GlassFish esteja em execução. Ele deve ter um sinal de seta verde ao lado. Se o servidor não estiver sendo executado, clique com o botão direito do mouse no nome do servidor e selecione Iniciar no menu de contexto.
- Abra o console Admin no seu navegador. Para isso, faça o seguinte:
- Clique com o botão direito do mouse no nó do servidor de aplicativo GlassFish V2 e selecione Propriedades no menu de contexto. A janela Servidores é aberta. No painel Servidores, GlassFish V2 deve ser selecionado.
- Na aba Conexão, copie o conteúdo do campo Localização (por padrão, ele é localhost:4848).
- Cole a string no navegador e pressione Enter. O Sun Java System Application Server Admin Console é aberto na janela do navegador.
- Faça login no console Admin usando o nome de usuário e a senha. Por padrão, o nome de usuário é admin e a senha é adminadmin.
- No painel esquerdo sob o nó JBI, selecione Componentes > sun-bpel-engine. A página de propriedades do mecanismo de serviço BPEL é aberta.
- Na página de propriedades do mecanismo de serviço BPEL, selecione a aba Registradores. Na aba Loggers você pode especificar níveis de log para os loggers individuais.
- Escolha o nível apropriado de log para sun-bpel-enginel na lista suspensa.
Se logging for definido para uma atividade do processo e o nível de log especificado para ela corresponder ao nível de log ajustado para o BPEL SE, após você realizar uma execução de teste do processo, o valor selecionado da variável será escrito no arquivo de log do servidor.
Observação: o projeto deverá ser implementado no servidor da aplicação.
Para exibir o arquivo de registro:
- Na janela Serviços, sob o nó Servidores, clique com o botão direito do mouse no nó do servidor de aplicativo GlassFish V2 e selecione Visualizar log do servidor no menu de contexto. O log do servidor GlassFish é aberto na janela Saída. O valor da mensagem da atividade será incluído no log; você pode usar Pesquisar para localizá-lo. Observe que algumas informações gerais ficam ocultas.
- Você também pode abrir o log em um editor de texto e ver as informações completas. Navegue até <diretório de instalação do servidor de aplicativo>/domains/domain1/log/ e abra o arquivo server.log com o editor de texto. As informações fornecidas no log incluem os seguintes itens divididos com a barra vertical:
- Data e hora da entrada
- Nível de log
- Tipo de gerenciador (para logging, este é Trace Manager)
- Segmento
- O valor da mensagem
Veja um exemplo de entrada de log:
[#|2008-03-25T09:26:18.796+0300|INFO|sun-appserver9.1|com.sun.jbi.engine.bpel.core.bpel.trace.BPELTraceManager|_ThreadID=26;_ThreadName=BPELSEInOutThread8;|<?xml version="1.0" encoding="UTF-8"?><jbi:message xmlns:msgns="http://localhost/SynchronousSample/SynchronousSample" name="input1" type="msgns:requestMessage" version="1.0" xmlns:jbi="http://java.sun.com/xml/ns/jbi/wsdl-11-wrapper"><jbi:part><syn:typeA xmlns:syn="http://xml.netbeans.org/schema/SynchronousSample">
<syn:paramA>Hello World</syn:paramA>
</syn:typeA></jbi:part></jbi:message>|#]
Definindo alertas
O alerta é definido de modo similar ao logging.
Quando o alerta deve ser realizado e o nível de alerta para a atividade são definidos no mapeador de Logging.
O modo de alerta (e-mail ou outro) e o nível de alerta para o BPEL SE são definidos no Sun Java System Application Server Admin Console.
- Consulte também
- Iniciando e interrompendo um servidor
- Realizando testes dos processos BPEL
- Sobre a depuração dos processos BPEL
Notificações legais