Agentes Jitterbit

Visão geral

Os agentes Harmony da Jitterbit processam as operações dos seus projetos de integração e enviam e recebem dados de endpoint. Existem dois tipos de agentes, nuvem e privado:

• Nuvem: A Jitterbit gerencia agentes de nuvem em sua própria infraestrutura de nuvem. Você não precisa configurar ou ajustar nada.

• Privado: Você deve configurar, ajustar e gerenciar agentes privados em sua própria infraestrutura de nuvem ou física.

Todos os agentes são membros de um grupo. Grupos de agentes são grupos de agentes do mesmo tipo (não é possível misturar agentes privados e de nuvem em um grupo). Os agentes em um grupo de agentes processam as operações do seu projeto no Integration Studio ou no Design Studio. Os grupos oferecem os seguintes benefícios:

• Roteamento inteligente: Para melhorar o desempenho e a confiabilidade, as operações de um projeto são enviadas para serem processadas por um grupo de agentes em vez de por agentes individuais. (Qual grupo de agentes um projeto utiliza depende do ambiente em que o projeto está implantado. A relação entre um ambiente e seu grupo de agentes é chamada de associação.) A menos que haja apenas um agente em um grupo, você não tem controle sobre qual agente processará uma operação—o sistema de roteamento inteligente decide qual agente usar.

  Este serviço de roteamento analisa os requisitos do trabalho e os compara com as capacidades individuais dos agentes (o que inclui seus conectores, versões e sistemas operacionais). A partir do conjunto de agentes capazes, uma estratégia de balanceamento de carga distribui a carga de trabalho, prevenindo gargalos. Se um agente designado estiver ocupado ou offline, o trabalho é redirecionado de forma transparente para outro agente disponível no grupo. Os trabalhos são despachados apenas para agentes que estão online e se comunicando ativamente com o Harmony. Se não houver agentes adequados disponíveis imediatamente, os trabalhos são automaticamente colocados em uma fila. O serviço, então, despacha o trabalho assim que um agente apropriado se torna disponível.

Porque esses mecanismos de balanceamento de carga consideram as capacidades e capacidades dos hosts ao compartilhar o trabalho, você pode provisionar hosts para corresponder mais de perto às cargas características de projetos ou ambientes, evitando a tendência de superprovisionar e gastar excessivamente em recursos.

• Alta disponibilidade: Se um agente ou seu host se tornar indisponível, e for o único agente em um grupo, quaisquer projetos de integração que utilizem esse grupo irão expirar e eventualmente falhar. Com múltiplos agentes em um grupo, seus projetos podem continuar em execução mesmo quando um agente está fora do ar, seja isso planejado (como no caso de atualizações de software) ou imprevisto. O nível de resiliência a falhas aumenta proporcionalmente com o número de agentes em um grupo.

• Escalabilidade: À medida que você melhora seu conhecimento sobre as características dinâmicas de seus projetos, pode adicionar ou remover agentes de grupos, ou criar novos grupos e ambientes dedicados a padrões operacionais específicos.

A tabela a seguir compara os dois tipos de agente:

Agentes em Nuvem

Agentes em nuvem são serviços em nuvem gerenciados pela Jitterbit. Eles são configurados para se adaptar automaticamente às cargas de trabalho do seu projeto. Você não precisa instalar, configurar, atualizar, iniciar ou parar os agentes em nuvem.

Grupos de Agentes em Nuvem

Grupos de agentes em nuvem são grupos de agentes em nuvem que executam a mesma versão. Eles estão incluídos em todas as assinaturas do Harmony. A Jitterbit fornece dois grupos de agentes em nuvem para cada região:

• Grupo de Agentes em Nuvem de Produção: Um grupo de agentes na versão atualmente lançada, totalmente testada e pronta para produção.

• Grupo de Agentes em Nuvem de Sandbox: Um grupo de agentes na próxima versão proposta, adequado para avaliação e testes.

Grupos de agentes em nuvem não precisam de configuração ou gerenciamento. Ao contrário dos agentes privados, os agentes em nuvem individuais não são visíveis no Console de Gerenciamento.

Agentes Privados

Ao contrário dos agentes em nuvem, que são gerenciados pela Jitterbit, você deve instalar e configurar agentes privados (em Windows, Linux), ou hosts Docker que atendam aos requisitos do sistema, e gerenciar tanto os agentes quanto os grupos usando a página Console de Gerenciamento > Agentes.

Você pode monitorar agentes privados com as métricas de observabilidade nativas da Jitterbit e com qualquer uma das plataformas de observabilidade de terceiros suportadas.

Grupos de agentes privados

Antes de instalar e executar um agente privado, é necessário ter pelo menos um grupo de agentes privados. (Grupos de agentes privados são uma adição licenciável à sua assinatura do Harmony.) Nenhum grupo de agentes privados é fornecido por padrão. Você deve criá-los e atribuí-los a ambientes. Um grupo de agentes privados deve ter pelo menos um agente privado, e um agente pode estar em apenas um grupo por vez.

Quando há dois ou mais agentes em um grupo, os agentes se revezam processando cadeias de operações inteiras, incluindo as filhas. Isso tem as seguintes consequências:

• Não há como prever em qual agente uma cadeia de operações será executada. Projetos com endpoints que requerem acesso a arquivos locais devem ser executados em um ambiente onde todos os agentes do grupo tenham acesso a um sistema de arquivos comum ou unidade compartilhada.

• A carga de trabalho média dos hosts de agentes individuais pode variar significativamente.

• Se um agente falhar, as operações podem travar e dados podem ser perdidos.

Para conectores suportados e um número mínimo de agentes ativos, você pode habilitar o serviço de escuta para agentes em um grupo. O serviço de escuta permite que conectores do Integration Studio suportados escutem eventos da API. Ele também nomeia um dos agentes como líder. O agente líder distribui tarefas de operação para os agentes de acordo com seu status e carga. Se um agente falhar, os dados podem ser recuperados.

Cronograma de lançamentos e notas de versão

O cronograma de lançamentos para agentes varia dependendo do tipo de agente:

• Grupos de agentes em nuvem são atualizados automaticamente nos cronogramas de atualização do Grupo de Agentes em Nuvem Sandbox e atualização do Grupo de Agentes em Nuvem de Produção.

• Instaladores de agentes privados atualizados ficam disponíveis na página de Downloads ao final do lançamento do Grupo de Agentes em Nuvem de Produção.

• A imagem do Docker do agente privado fica disponível no Docker Hub ao final do lançamento do Grupo de Agentes de Nuvem de Produção da região da América do Norte (NA).

Nos notas de lançamento do Harmony, cada tipo de agente é incluído como um item separado na tabela de datas de lançamento no topo de cada página de notas de lançamento. As notas de lançamento individuais estão listadas sob o cabeçalho Agentes, com qualquer aplicabilidade relevante a certos tipos de agentes incluída nas notas de lançamento.

Compilações de notas de lançamento para Grupos de Agentes de Nuvem de Produção, Grupos de Agentes de Nuvem Sandbox e agentes privados também estão disponíveis.

Problemas conhecidos

Esta seção lista problemas conhecidos que foram identificados com versões recentes de agentes privados. Para problemas conhecidos que foram identificados com outros aplicativos Jitterbit Harmony, veja Problemas conhecidos.

Múltiplas versões de agentes privados

Agentes privados Linux 11.31.1 e todas as versões anteriores

• Operações agendadas falham ao serem executadas após a reinicialização de um agente privado Linux

  • Resumo: Após reiniciar um agente privado Linux, o serviço Scheduler do agente falha ao iniciar, fazendo com que as operações agendadas não sejam executadas conforme o esperado. Este problema não ocorre com agentes privados Windows.

  • Informações Adicionais: O serviço Scheduler do agente Linux utiliza uma biblioteca que baixa os arquivos de dados de fuso horário mais recentes. A partir de 4 de setembro de 2024, o fornecedor dessa biblioteca introduziu um erro de sintaxe que impede o serviço Scheduler de iniciar.

  • Recomendação: Este problema é resolvido com a versão 11.31.2, que não baixa mais automaticamente a biblioteca que causa o problema. Recomendamos atualizar os agentes privados Linux para 11.31.2 ou posterior para evitar que esse problema ocorra e, nos casos em que já está ocorrendo, para se recuperar dele.

Alternativamente, se você estiver usando uma versão anterior do agente, pode aplicar a seguinte solução alternativa ou etapas de recuperação para agentes não-Docker:

• Solução alternativa: Se um agente privado Linux ainda não foi reiniciado, para evitar que esse problema ocorra, edite o arquivo version em /opt/jitterbit/TimeZoneDB/version e altere seu valor para 2024b. Isso impedirá que a versão da biblioteca de datas com o problema seja baixada pelo agente.

• Recuperação: Se um agente privado Linux já estiver enfrentando esse problema, para corrigi-lo, edite o arquivo northamerica em /opt/jitterbit/TimeZoneDB/northamerica para substituir o valor April por Apr em todas as ocorrências. Em seguida, reinicie o agente.

Todas as versões recentes

Esses problemas se aplicam a todas as versões recentes:

• A instalação do agente privado do Windows exibe um aviso do Microsoft Defender SmartScreen

  • Resumo: Ao instalar um agente privado 10.69 ou posterior (para agentes 10.x) ou 11.8 ou posterior (para agentes 11.x) no Windows 2019 ou Windows 10, uma mensagem de aviso pode aparecer.

  • Informações adicionais: A mensagem de aviso diz "O Windows protegeu seu PC" com uma observação de que o Microsoft Defender SmartScreen impediu que um aplicativo não reconhecido fosse iniciado.

  • Solução alternativa: Dentro da caixa de diálogo da mensagem de aviso, clique em Mais informações para mostrar a opção Executar assim mesmo. Em seguida, clique em Executar assim mesmo para prosseguir com a instalação do agente.

• Agentes privados do Windows: Incapaz de instalar agente de 64 bits com Autenticação de Dois Fatores (TFA)

  • Resumo: A instalação de um agente privado do Windows de 64 bits falha se a TFA estiver ativa.

  • Informações adicionais: O instalador exibe uma caixa de diálogo de erro.

  • Solução alternativa: Desative temporariamente a TFA e instale o agente privado do Windows de 64 bits. Após a instalação, ative a TFA.

• Conexões ODBC não lidam corretamente com caracteres estendidos

  • Resumo: Ao conectar-se a um banco de dados usando um driver ODBC, alguns caracteres estendidos, como um traço longo, não são tratados corretamente por operações que atualizam ou inserem dados.

• Informações Adicionais: Operações de Upsert podem falhar ou ter consequências indesejadas ao afetar os dados errados. Observe que operações de Inserção e Atualização não são afetadas por esse problema.

• Solução Alternativa: Use um driver JDBC para a conexão com o Banco de Dados (veja as instruções para Design Studio ou Integration Studio).

• Diretórios SFTP às vezes não são criados automaticamente

  • Resumo: Ao gravar em SFTP como um destino usando o Design Studio ou o Integration Studio, a criação automática de diretórios funciona de forma inconsistente.

  • Informações Adicionais: Dependendo do servidor FTP específico envolvido, o diretório pode não ser criado.

  • Solução Alternativa: Confirme se o diretório foi criado antes do uso em produção.

• SetSalesforceSession a função não funciona

  • Resumo: A função do Jitterbit Script SetSalesforceSession não funciona corretamente e não deve ser usada no Design Studio ou no Integration Studio.

  • Informações Adicionais: Se usada, o script pode ou não gerar um erro. Mesmo que o script não gere um erro, a função não funcionará corretamente. Como a função não funciona, o gerenciamento de sessão embutido do conector Salesforce será utilizado.

• Agentes privados têm requisitos de sistema específicos e problemas conhecidos

  • Resumo: Os agentes privados têm requisitos de sistema diferentes e específicos e problemas conhecidos, dependendo do sistema operacional utilizado.

  • Solução Alternativa: Veja os Requisitos de sistema para agentes privados para mais detalhes.

• A instalação do agente falha devido à senha do PostgreSQL incluir um sinal de mais (+)

  • Resumo: A instalação do agente privado falha se a senha do PostgreSQL contiver um sinal de mais (+). Nenhuma mensagem de erro é exibida.

  • Informações Adicionais: Este é um problema com o instalador do agente privado, não com o PostgreSQL.

  • Solução Alternativa: Use uma senha sem um sinal de mais (+). Quando a instalação estiver completa, a senha pode ser alterada para qualquer senha aceitável para uso com PostgreSQL.

11.26 agentes privados

• O parâmetro claims da função VerifyJwtClaims não tem valor padrão correto quando deixado vazio

  • Resumo: Ao usar a versão do agente 11.26, deixar o parâmetro opcional claims vazio na função Jitterbit Script VerifyJwtClaims gerará um erro.

  • Solução Alternativa: Atualize para a versão do agente 11.27 ou posterior ou insira "{}" para claims. Por exemplo, VerifyJwtClaims("AxE9qm4aTZiXvA2G8sblAxjeL...", "RS256", "Secret", "{}");.

10.87 / 11.25 e versões anteriores de agentes privados

• Entradas de log excessivas para o conector Microsoft Azure Service Bus

  • Resumo: Ao usar o conector Microsoft Azure Service Bus com a versão do agente 10.87 / 11.25 ou anterior, um número excessivo de logs INFO é gerado em um curto período de tempo, levando a problemas de espaço em disco devido ao tamanho do arquivo catalina.out.

  • Solução Alternativa: Recomenda-se uma atualização para a versão do agente 11.26 ou posterior. Como alternativa, esse problema pode ser resolvido na versão do agente 10.87 / 11.25 ou anterior adicionando as seguintes configurações ao arquivo logback.xml localizado em C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) ou /opt/jitterbit/tomcat/shared/lib (Linux):

    <logger name="com.azure.core.amqp" level="ERROR"/>
    <logger name="com.azure.messaging.servicebus" level="ERROR"/>
    <logger name="com.azure.core.implementation" level="ERROR"/>
    

10.84 / 11.22 e agentes privados anteriores

• Agendamento diário único pulado durante a troca de horário de verão

  • Resumo: Ao usar a versão do agente 10.84 / 11.22 ou anterior, e o agente estiver usando um fuso horário que observa o horário de verão, ocorrem os seguintes problemas conhecidos durante a troca de horário de verão:

    • Quando um agendamento diário único é definido entre 1 - 2 AM, a operação agendada não será executada no primeiro domingo de novembro devido ao horário de verão.

    • Quando um agendamento diário único é definido entre 2 - 3 AM, a operação agendada não será executada no segundo domingo de março devido ao horário de verão.

  • Solução alternativa: Atualize para a versão do agente 10.85 / 11.23 ou posterior ou defina o fuso horário do agente para UTC usando a Substituição do Fuso Horário do Agente de Agendamento política da organização e selecionando Etc/UTC.

10.45 e agentes privados anteriores

• Vulnerabilidades do Apache Log4j2 JNDI afetam agentes privados

  • Resumo: As vulnerabilidades do Apache Log4j2 CVE-2021-44228 e CVE-2021-45046 afetam agentes privados que usam conectores do Integration Studio construídos com o SDK do Conector do Integration Studio.

  • Mitigação: Uma manutenção de emergência abordou as vulnerabilidades. Após a manutenção, os agentes privados precisaram ser reiniciados e uma operação executada para cada conector afetado para que a atualização se tornasse efetiva. Para informações detalhadas e instruções, veja Mitigar a vulnerabilidade do Apache Log4j2 JNDI.

10.38 Agentes privados Linux

• O banco de dados PostgreSQL é re-inicializado ao atualizar da versão 10.37 para 10.38

  • Contexto: Ao atualizar um agente privado Linux de uma versão anterior à 10.37 para uma versão que seja 10.37 ou posterior, o banco de dados PostgreSQL será re-inicializado à medida que é atualizado para a versão 9.6. Essa atualização recriará o banco de dados em seu agente privado e seus dados serão recuperados durante esse processo de atualização. Após a atualização, quaisquer backups criados usando uma versão anterior do PostgreSQL não serão compatíveis. O processo de atualização pode levar mais de 30 minutos, dependendo do número de projetos e do tamanho dos ambientes associados ao seu grupo de agentes privados. Quaisquer trabalhos pendentes serão colocados em uma fila de espera para serem executados após a conclusão da atualização. Essa atualização não envolve o agente privado Windows.

  • Problema Conhecido: É um problema conhecido que ao atualizar um agente privado Linux da versão 10.37 para 10.38, o banco de dados PostgreSQL é re-inicializado.

  • Solução Alternativa: Atualize para um agente privado Linux que seja da versão 10.39 ou posterior.

10.0 agentes privados

• O conector Cherwell do Integration Studio não funciona

  • Resumo: A partir da versão 10.1 do Harmony, uma mudança feita no conector Cherwell no Integration Studio significa que ele não é mais compatível com agentes 10.0.

  • Solução Alternativa: Se estiver usando o conector Cherwell, por favor, atualize para agentes 10.1 ou superiores.

9.8 agentes privados

• Plugins não estão sendo executados

  • Resumo: Um problema com plugins que falham ao executar resultou na retirada do download do agente privado 9.8 logo após o lançamento.

  • Solução Alternativa: Se você ainda tiver um agente privado 9.8, por favor, atualize para uma versão posterior.