Logs de operação no Jitterbit Integration Studio

Introdução

Quando uma operação é executada, um log de operação é gerado. Um log de operação contém informações sobre quando e onde uma operação foi executada, o status da operação e quaisquer mensagens de log. Se mensagens de log detalhadas são exibidas depende dos níveis de permissão e acesso e se o log de nuvem está habilitado. Quando o log de depurar de operação (para agentes de nuvem ou para agentes privados) estiver habilitado para uma operação individual, cada log de operação também contém dados de entrada e saída para a operação.

Os logs de operação, incluindo mensagens de log detalhadas de agentes de nuvem e agentes privados, e dados de entrada e saída de componentes dentro dos logs de operação, são retidos por 30 dias pelo Harmony.

Os logs de operação também podem ser visualizados no Management Console Operações de tempo de execução página.

Para obter informações sobre como resolver certos erros que podem ocorrer ao executar uma operação, consulte Solução de problemas de operação.

Logs de operação de acesso

Os registros de operação podem ser acessados em Integration Studio no nível do workflow, operação ou projeto. Dependendo de onde eles são acessados, a tela de log de operação inclui um máximo de 1.000 logs para um determinado período de tempo para operações que foram executadas em um workflow específico, para uma operação específica ou em um projeto, respectivamente. Se as operações estiverem vinculadas com ações de operação ou o RunOperation função, logs para operações abaixo também estão incluídos.

Por workflow

A opção Exibir Logs para um workflow, que mostra logs para operações que foram executadas dentro de um workflow específico, pode ser acessada na aba Workflows do painel do projeto (consulte menu de ações do Workflow na aba Workflows do painel Projeto).

Por operação

A opção Exibir logs para uma operação pode ser acessada nestes locais:

• A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A quadro de design (veja menu de ações do componente em Tela de design).

Além disso, após executar uma operação manualmente, você pode clicar no status da operação na quadro de design para exibir os logs (consulte Status da operação em Implantação e execução da operação).

Por projeto

Ao usar a opção Exibir Logs de um projeto, as Operações de Tempo de Execução do Console de Gerenciamento é aberta em uma nova aba do navegador e é filtrada para exibir logs de operações que foram executadas dentro do projeto.

A opção Exibir logs de um projeto pode ser acessada nestes locais:

• A página Projetos (veja Visualização de cartão ou Visualização de lista em Projetos).
• A barra de ferramentas do projeto (veja menu de ações do projeto em Barra de ferramentas do projeto).

Gaveta de registro de operação

Ao visualizar logs por workflow ou operação, uma gaveta de log de operação é aberta na parte inferior da quadro de design para manter seu contexto no projeto:

• Guias: As guias na parte superior da gaveta de logs de operação são rotuladas com Registro seguido pelo nome da operação ou workflow (dependendo de onde os logs foram acessados). Quando você acessa logs adicionais, novas guias são adicionadas. Para reordenar as guias, arraste e solte uma aba. Para fechar uma aba, clique em seu ícone de fechamento. Fechando a última aba ou usando o ícone mais à direita ícone de fechamento fecha a gaveta de log.
• Redimensionar: A barra ao longo da parte superior da gaveta de log pode ser usada para redimensionar a gaveta de log. Passe o mouse sobre a barra e arraste o redimensione o ícone para cima ou para baixo para redimensionar a gaveta de log.
• Recolher: Recolhe a gaveta de logs para que todos os logs fiquem ocultos. Depois de recolhido, clique no ícone de retorno para retornar à visualização anterior.
• Expandir: Expande a gaveta de log para tela cheia para que quaisquer logs adicionais sejam exibidos. Uma vez expandido, clique no ícone de retorno para retornar à visualização anterior.
• Abrir em uma nova aba: Abre a visualização do log de operação em tela cheia em uma nova aba.
• Fechar: Fecha a gaveta de log.

Controles da tabela de log de operação

O log de operação vista de gaveta inclui filtros para período de tempo e consultas, e tabela atualizar.

Prazo

Todos os períodos de tempo são exibidos como o horário local do navegador. Por padrão, o período de tempo é definido como Últimas 24 horas de logs desde a última execução de uma operação. Como alternativa, use o menu para selecionar Últimas 48 horas, Últimas 72 horas ou Horário personalizado:

Para um determinado período de tempo, um máximo de 1.000 logs são incluídos na tabela de logs de operação.

Quando Hora personalizada é selecionado, uma caixa de diálogo de configuração é aberta:

• Concluído: Para filtrar pela data e hora em que a operação ou etapa de operação parou de ser executada, clique em ícone de calendário para abrir o seletor de data. Para limpar este campo, clique no ícone de filtro limpo.
• Iniciado: Para filtrar pela data e hora em que a operação ou etapa de operação começou a ser executada, clique em ícone de calendário para abrir o seletor de data. Para limpar este campo, clique no ícone de filtro limpo.
• Aplicar: (Habilitado quando os campos Concluído ou Iniciado estão configurados.) Aplica todos os filtros de data e hora à tabela de logs de operação.
• Limpar: (Habilitado quando os campos Concluído ou Iniciado estão configurados.) Limpa os filtros Concluído e Iniciado.

Uma vez que um o ícone de calendário é clicado, o seletor de data/hora é aberto para esse campo:

• Data de/para: Use o calendário em um ou ambos os campos para selecionar uma data nos últimos 30 dias.

  • Mês: O mês atual é usado por padrão. Use o setas para navegar para um mês diferente.

  • Dia: Selecione o dia desejado no calendário.

• Hora: Digite a hora, o minuto e o período de tempo (AM ou PM).

Atualizar

Os logs são atualizados automaticamente a cada cinco segundos se alguma operação ainda estiver em estado de execução (status de Recebido, Enviado, Pendente ou Em execução).

Você também pode atualizar manualmente os logs a qualquer momento para exibir informações atualizadas. Para atualizar manualmente os logs, clique no ícone Atualizar no canto superior direito.

Consultas

Uma consultar é um ou mais termos de chave/valor. Vários termos são separados por ponto e vírgula. Um termo tem o formato <key><operator><value>. Para o operation chave, o valor pode incluir um caractere curinga, %, que corresponde a qualquer string.

Para usar uma consultar, insira uma especificação de consultar válida na barra de pesquisa e pressione Enter:

A tabela a seguir mostra os componentes de termos de consultar disponíveis:

Status de operação

A seguir estão os status que podem ser consultados ao usar o status chave:

• Erro: Se o agente concluir a execução de uma operação, mas houver um erro fatal na gravação no sistema de destino, ou houver um erro fatal de validação na transformação, ou a lógica de transformação tiver acionado o RaiseError função, então o status da operação é definido como Erro e a execução da operação é encerrada.

• Falha SOAP: Se o agente concluir a execução de uma operação e o resultado for uma falha SOAP, o status será definido como Falha SOAP. Esse status é aplicável somente para operações que usam Salesforce, Salesforce Service Cloud, ServiceMax, SOAP, ou Workday atividades.

• Enviado: Quando as operações são enviadas para a fila Harmony, mas ainda não foram selecionadas por um agente para execução, elas têm um status Enviado. As operações podem ser enviadas por vários meios:

  • Serviço de agendamento Jitterbit ou serviço de agendamento externo
  • Execução manual da operação em Integration Studio
  • Um RunOperation função de um script ou transformação
  • Qualquer ferramenta, incluindo JitterbitUtils, que chama uma API do API Manager

• Recebido: Depois que um agente é escolhido e o agente reconhece que recebeu a solicitação para executar uma operação, o status é alterado para Recebido.

• Pendente: Depois que uma operação é agendada para ser executada no mecanismo de operação de um agente, o status é alterado para Pendente. As operações não devem ficar no status Pendente por longos períodos, pois os agentes devem pegar a solicitação e começar a executar as operações em um curto espaço de tempo.

• Em execução: Assim que o agente começar a executar uma operação, o status deve mudar para Em execução. As operações permanecem nesse status até que sejam concluídas ou encontrem um erro. O agente começa a registrar mensagens geradas pela operação conforme ela é executada para que os usuários possam rastrear qual parte da operação está sendo executada no momento.

• Cancelamento Solicitado: Indica que uma solicitação para interromper a operação foi enviada. Se um usuário quiser interromper uma operação que esteja no status Enviado, Recebido, Pendente ou Em Execução, ele pode fazer isso a partir destes locais:

  • A operação (veja status da operação em Tela de design).
  • A tabela de log de operação.
  • As Operações de Tempo de Execução página do Management Console (veja Cancelamento de operações de tempo de execução).

  Alternativamente, eles podem habilitar outra operação para cancelar uma operação usando uma combinação de GetOperationQueue e CancelOperation funções. Uma vez que um cancelamento é solicitado, o status da operação muda para Cancelamento Solicitado. Uma operação não deve permanecer neste status por muito tempo, pois o agente deve cancelar a operação em um período de tempo relativamente curto.

• Cancelado: Quando um agente cancela uma operação, ele define o status como Cancelado e a operação é encerrada. Todas as informações de log até o ponto de cancelamento estão disponíveis para revisão nas mensagens de log para que você saiba em que ponto a operação foi cancelada.

• Sucesso: Uma vez que um agente conclui a execução de uma operação, se o resultado foi um sucesso sem avisos do sistema de destino, ou aviso escrito na transformação usando o WriteToOperationLog função, então o status é definido como Sucesso.

• Sucesso com informações: Se o agente concluir a execução de uma operação, mas houver problemas não fatais na transformação ou na publicação no sistema de destino ou no WriteToOperationLog a função foi usada para escrever mensagens no log, então o status é definido como Sucesso com Info. Isso alerta o usuário para verificar informações nas mensagens de log.

• Sucesso com Aviso: Se o agente concluir a execução de uma operação, mas houver problemas não fatais na transformação ou na publicação no sistema de destino, e houver um aviso, o status será definido como Sucesso com Aviso. Isso alerta o usuário para verificar se há avisos nas mensagens de log.

• Sucesso com erro filho: Se o agente concluir a execução bem-sucedida de uma operação, mas dentro de uma ou mais operações filho, houve um erro fatal na gravação no sistema de destino, ou houve um erro fatal de validação na transformação, ou a lógica da transformação acionou o RaiseError function, então o status da operação é definido como Success with Child Error. Esse status não se aplica a operações assíncronas.

• Status Atrasado: Se o agente não retornar um log de operação por qualquer motivo, Status Atrasado será exibido. O Harmony tentará buscar logs seis vezes, com um tempo limite de 10 segundos entre cada chamada. Atualize ou verifique os logs novamente mais tarde. Você não pode filtrar por operações com Status Atrasado, mas pode vê-las nos logs de operação.

Status da etapa da operação

As etapas da operação aparecem somente quando a operação tem o registro de depurar de operação habilitado no nível da operação (para agentes de nuvem ou para agentes privados) e a operação foi executada em um agente 10.48 ou posterior.

As etapas da operação podem ter estes possíveis status:

• Concluído: A etapa de operação foi executada e concluída sem erros.
• Erro: A etapa de operação foi executada, mas não pôde ser concluída devido a um erro.
• Incompleto: A etapa de operação não foi executada ou concluída. Possíveis motivos para esse status incluem que a etapa de operação está aguardando para ser executada ou que houve um erro em uma etapa de operação anterior impedindo a execução da etapa seguinte.

Tabela de log de operação

A tabela de log de operação exibe os logs de operação usando os [controles de tabela] selecionados.#controls). Se as operações estiverem vinculadas com ações de operação ou o RunOperation função, logs para operações abaixo também estão incluídos.

As operações pai (e quaisquer operações filho abaixo delas) são classificadas em ordem crescente por Iniciado. A tabela pode ser classificada (somente para operações de nível superior) por Nome, Iniciado, Concluído, Duração ou Status clicando na respectiva linha de cabeçalho.

São exibidos no máximo 1000 logs de operação. Para visualizar logs de operações adicionais, ajuste os filtros de acordo.

• Nome: O nome da operação ou etapa de operação. O triângulos de divulgação, que podem ser usados para expandir ou recolher linhas adicionais, são mostrados em operações pai e em operações para as quais dados de entrada e saída de componentes estão disponíveis:

  • Operações pai: Quando uma operação pai é expandida, linhas adicionais para suas operações filho aparecem na ordem em que foram executadas. Por padrão, todas as operações pai são expandidas. Use o recolher lista ou expanda os ícones da lista no cabeçalho da coluna para recolher ou expandir todas as operações pai.

  • Operação com dados de entrada e saída: Quando uma operação com dados de entrada e saída é expandida, linhas adicionais para cada etapa de operação aparecem na ordem em que foram executadas. Mais informações são fornecidas em Dados de entrada e saída do componente.

• Entrada/Saída: Esta coluna é exibida somente quando a tabela contém uma operação que tem o registro de depurar de operação habilitado no nível da operação (para agentes de nuvem ou para agentes privados) e a operação foi executada em um agente 10.48 ou posterior. Os dados de entrada e saída acessados por meio desta parte da tabela de log são descritos em Dados de entrada e saída do componente.

• Iniciado: A data e a hora em que a operação ou etapa de operação começou a ser executada, exibida como o horário local do navegador.

• Concluído: A data e a hora em que a operação ou etapa de operação parou de ser executada, exibida como o horário local do navegador.

• Duração: Tempo decorrido entre Iniciado e Concluído, relatado em segundos para operações e em milissegundos para etapas de operação.

• Status: O status da operação ou etapa de operação. Para uma lista completa de status possíveis, consulte Status da operação anteriormente nesta página.

• Ações: Esta ação está disponível:

  • Cancelar operação: Habilitado para operações que estão nos status Enviado, Recebido, Pendente ou Em execução.

    Cancelar operação envia uma solicitação ao agente para interromper a operação. Após clicar, o status Cancelar Solicitado é exibido ao lado do status da operação em tempo real.

    Nota

    Operações com status Cancelamento Solicitado ainda podem ser executadas.

• Registro de operação: Para mostrar ou ocultar um registro de uma operação individual, clique em qualquer lugar em uma linha de operação, exceto nos ícones mostrados na coluna Entrada/Saída (se houver):

  

  • Mensagens de log: As mensagens de log incluem os detalhes do log para a operação selecionada. Se as mensagens de log são exibidas depende das permissões e níveis de acesso do usuário atual e se o registro em nuvem está habilitado. Para obter mais informações, consulte aba Mensagens no Management Console Operações de Tempo de Execução documentação da página.

    Nota

    Datas e horários exibidos nas próprias mensagens de log não são convertidos para o horário local do navegador, mas são relatados em seu formato original da fonte da mensagem de log.

  • Copiar: Copia os dados de log para sua área de transferência.

  • Download: Baixa as mensagens de log como um arquivo de texto.

  • Mostrar / ocultar: Mostra ou oculta as mensagens de log.

Dados de entrada e saída do componente

Os dados de entrada e saída do componente são gerados quando uma operação tem o registro de depurar de operação habilitado no nível da operação (para agentes de nuvem ou para agentes privados) e a operação foi executada em um agente 10.48 ou posterior.

Quando dados de entrada e saída do componente estão presentes, uma coluna Entrada/Saída mostrando uma representação gráfica da operação ou etapa de operação é exibida na tabela de log da operação.

Na coluna Entrada/Saída, os ícones para atividades e transformações usadas como etapas de operação podem ser clicados para mostrar ou ocultar os dados de entrada e saída do componente para essa etapa de operação individual. Cada entrada de log de entrada e saída é limitada a 100 MB. Se os dados para uma entrada de log de entrada ou saída individual excederem 100 MB, nenhum dado será exibido.

• Pesquisar: Pesquise os dados para o texto inserido.

• Copiar: Copia os dados de log para sua área de transferência.

• Download: Baixa os dados de entrada ou saída como um arquivo no formato de dados apropriado. O arquivo é nomeado com o nome da etapa de operação seguido por _input ou _output conforme apropriado.