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 endpoints. Existem dois tipos de agente, cloud e privado:

• Cloud: A Jitterbit gerencia agentes cloud na sua própria infraestrutura cloud. Você não precisa configurar ou definir nada.

• Privado: Você deve configurar, definir e gerenciar agentes privados na sua própria infraestrutura cloud ou física.

Todos os agentes são membros de um grupo. Os grupos de agentes são compostos por agentes do mesmo tipo (você não pode misturar agentes privados e cloud em um grupo). Os agentes em um grupo de agentes processam as operações do seu projeto Studio ou 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 processamento por um grupo de agentes em vez de agentes individuais. (Qual grupo de agentes um projeto usa depende do ambiente em que o projeto é 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 de agentes individuais (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, evitando gargalos. Se um agente designado está ocupado ou offline, o trabalho é roteado perfeitamente 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 nenhum agente adequado estiver imediatamente disponível, os trabalhos são automaticamente colocados em fila. O serviço então despacha o trabalho assim que um agente apropriado fica disponível.

  Como esses mecanismos de balanceamento de carga consideram as capacidades e a capacidade dos hosts ao compartilhar o trabalho, você pode provisionar hosts para corresponder mais aproximadamente aos padrões característicos de carga de projetos ou ambientes, evitando a tendência de sobre-provisionar e gastar excessivamente com recursos.

• Alta disponibilidade: Se o status de um agente se tornar Stopped por qualquer motivo, o sistema cancela qualquer operação agendada atribuída a ele e executa novamente novas instâncias de operação quando o agente estiver ativo. Se o agente for o único em um grupo, as operações de integração usando esse grupo eventualmente atingem o tempo limite e falham. Com vários agentes em um grupo, as operações agendadas em execução em um agente Stopped são canceladas e imediatamente recriadas em um agente ativo. Isso garante que seus projetos continuem em execução mesmo quando um agente falha, seja este um evento planejado (como no caso de atualizações de software) ou não previsto. O nível de resiliência a falhas aumenta proporcionalmente com o número de agentes em um grupo.

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

A tabela a seguir compara os dois tipos de agente:

Agentes na nuvem

Agentes na nuvem são serviços em nuvem gerenciados pela Jitterbit. Eles são configurados para se adaptar automaticamente de acordo com as cargas de trabalho do seu projeto. Não é necessário instalar, configurar, atualizar, iniciar ou parar agentes na nuvem.

Grupos de agentes na nuvem

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

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

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

Grupos de agentes na nuvem não requerem configuração ou gerenciamento. Diferentemente dos agentes privados, agentes na nuvem individuais não são visíveis no Management Console.

Agentes privados

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

Você pode monitorar agentes privados com as métricas de observabilidade nativa 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 um complemento licenciável à sua assinatura 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 alternam processando cadeias de operação completas, incluindo filhos. Isso tem as seguintes consequências:

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

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

• Se um agente falhar, as operações podem ficar suspensas 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 Studio suportados escutem eventos de API. Ele também designa um dos agentes como líder. O agente líder distribui tarefas de operação para agentes de acordo com seu status e carga. Se um agente falhar, os dados podem ser recuperados.

Cronograma de lançamento e notas de lançamento

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

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

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

• A imagem Docker do agente privado fica disponível no Docker Hub após a conclusão do lançamento do Production Cloud Agent Group da região América do Norte (NA).

Nas notas de lançamento do Harmony, cada tipo de agente aparece como um item de linha 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 título Agents, com qualquer aplicabilidade relevante a certos tipos de agentes incluída nas notas de lançamento.

Compilações de notas de lançamento para Production Cloud Agent Groups, Sandbox Cloud Agent Groups e agentes privados também estão disponíveis.

Problemas conhecidos

Esta seção lista os problemas conhecidos identificados em versões recentes de agentes privados. Para problemas conhecidos identificados em outros aplicativos do Jitterbit Harmony, consulte Problemas conhecidos.

Múltiplas versões de agentes privados

Agentes privados Windows 12.3

• Instalador do agente privado Windows 12.3 removido devido a um problema conhecido

  • Resumo: Um problema conhecido com a versão 12.3 do agente privado Windows causou a remoção do instalador pouco após o lançamento.

  • Solução alternativa: Se você já instalou a versão 12.3 do agente no Windows, atualize para a versão 12.4 ou posterior do agente.

Agentes privados Linux 11.31.1 e todas as versões anteriores

• Operações agendadas falham ao executar após uma reinicialização do agente privado Linux

  • Resumo: Após reiniciar um agente privado Linux, o serviço Scheduler do agente falha ao iniciar, fazendo com que operações agendadas não sejam executadas como 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 provedor dessa biblioteca introduziu um erro de sintaxe que causa falha na inicialização do serviço Scheduler.

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

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

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

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

Agentes privados Windows 11.44 até 11.58

• Falha na atualização pode remover o serviço PostgreSQL

  • Resumo: Ao atualizar um agente privado Windows de uma versão anterior à 11.44 para uma versão entre 11.44 e 11.58, inserir uma senha incorreta da conta de serviço PostgreSQL no prompt do instalador pode fazer com que a atualização falhe sem reverter corretamente, resultando em tempo de inatividade do agente.

  • Informações adicionais: Este problema foi resolvido no agente privado 11.59 / 12.3 e posteriores, onde uma senha incorreta é detectada antes do início da atualização, um erro de validação é exibido no mesmo diálogo, e cancelar o instalador deixa o agente existente intacto.

  • Solução alternativa: Se você já enfrentou este problema, consulte Serviço PostgreSQL removido após falha na atualização no Windows para etapas de recuperação. Para evitar o problema antes de atualizar, certifique-se de que sabe a senha da conta de serviço PostgreSQL. Se for desconhecida, consulte Redefinir a senha do administrador PostgreSQL antes de atualizar.

Todas as versões recentes

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

• Instalação de agentes privados non-root RHEL 9.7 e posterior mostra um erro de OpenSSL

  • Resumo: Agentes privados non-root do Red Hat Enterprise Linux (RHEL) 9.7 e posterior falham ao iniciar devido à versão 3.5 do OpenSSL.

  • Informações Adicionais: O erro ImportError: /opt/jitterbit/lib/libcrypto.so.3: version 'OPENSSL_3.4.0' not found (required by /usr/lib64/python3.9/lib-dynload/_hashlib.cpython-39-x86_64-linux-gnu.so) é exibido. Esse problema não ocorre no RHEL 9.6 e anterior, onde o OpenSSL é versão 3.0.14.

  • Solução alternativa para agentes privados 12.x: Renomeie as bibliotecas OpenSSL fornecidas para usar as bibliotecas OpenSSL 3.5 fornecidas pelo sistema RHEL:

    cd /opt/jitterbit/lib
    sudo mv libcrypto.so.3 libcrypto.so.3.bak
    sudo mv libssl.so.3 libssl.so.3.bak
    

  • Solução alternativa para agentes privados 11.x: Desabilite LD_LIBRARY_PATH e reinicie o agente com JITTERBIT_HOME definido explicitamente:

    unset LD_LIBRARY_PATH
    export JITTERBIT_HOME=/opt/jitterbit
    sudo JITTERBIT_HOME=/opt/jitterbit env -u LD_LIBRARY_PATH jitterbit restart
    

• Instalação de agente privado Windows mostra 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 "Windows protegeu seu PC" com uma observação de que o Microsoft Defender SmartScreen impediu que um aplicativo desconhecido fosse iniciado.

  • Solução alternativa: Na caixa de diálogo 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 Windows: Impossível instalar agente 64-bit com autenticação de dois fatores (TFA)

  • Resumo: A instalação de um agente privado Windows 64-bit falha se o TFA estiver ativo.

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

  • Solução alternativa: Desabilite temporariamente o TFA e instale o agente privado Windows 64-bit. Após a instalação, habilite o TFA.

• Conexões ODBC não tratam caracteres estendidos corretamente

  • Resumo: Ao conectar a um banco de dados usando um driver ODBC, alguns caracteres estendidos, como um travessão, não são tratados adequadamente por operações que fazem upsert de dados.

  • Informações Adicionais: Operações de upsert podem falhar ou ter sucesso com consequências não intencionais afetando dados incorretos. 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 de banco de dados (consulte as instruções para Design Studio ou Studio).

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

  • Resumo: Ao escrever para SFTP como um destino usando Design Studio ou 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.

• Função SetSalesforceSession não funciona

  • Resumo: A função Script do Jitterbit SetSalesforceSession não funciona corretamente e não deve ser usada no Design Studio ou 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 tratamento de sessão integrado do conector Salesforce será usado.

• 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 usado.

  • Solução alternativa: Consulte os Requisitos de sistema para agentes privados para obter detalhes.

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

  • Resumo: A instalação do agente privado falha se a senha 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 PostgreSQL.

  • Solução alternativa: Use uma senha sem um sinal de mais (+). Quando a instalação for concluída, 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 assume o valor padrão correto quando deixado vazio

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

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

10.87 / 11.25 e agentes privados anteriores

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

  • Resumo: Ao usar o conector Microsoft Azure Service Bus com a versão 10.87 / 11.25 do agente 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 como resultado do tamanho do arquivo catalina.out.

  • Solução alternativa: Recomenda-se uma atualização para a versão 11.26 ou posterior do agente. Como alternativa, esse problema pode ser resolvido na versão 10.87 / 11.25 do agente 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 ignorado durante mudança de horário de verão

  • Resumo: Ao usar a versão 10.84 / 11.22 do agente ou anterior, e o agente está usando um fuso horário que observa horário de verão, esses problemas conhecidos ocorrem durante uma mudança de horário de verão:

    • Quando um agendamento diário é 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 é 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 10.85 / 11.23 ou posterior do agente ou defina o fuso horário do agente como UTC usando a política de organização Override Schedule Agent Time Zone e selecionando Etc/UTC.

10.45 e agentes privados anteriores

• Vulnerabilidades Apache Log4j2 JNDI afetam agentes privados

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

• Mitigação: uma manutenção de emergência abordou as vulnerabilidades. Após a manutenção, foi necessário reiniciar os agentes privados e executar uma operação para cada conector afetado para que a atualização entrasse em vigor. Para informações detalhadas e instruções, consulte Mitigar a vulnerabilidade JNDI do Apache Log4j2.

10.38 Agentes privados Linux

• O banco de dados PostgreSQL é reinicializado 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 10.37 ou posterior, o banco de dados PostgreSQL será reinicializado conforme é atualizado para a versão 9.6. Esta atualização recriará o banco de dados no seu agente privado e os dados serão recuperados durante este processo de atualização. Após a atualização, 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. Todos os trabalhos pendentes serão colocados em uma fila de espera para serem executados após a conclusão da atualização. Esta 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 é reinicializado.

  • Solução alternativa: atualize para um agente privado Linux com versão 10.39 ou posterior.

10.0 Agentes privados

• O conector Studio Cherwell não funciona

  • Resumo: a partir do lançamento do Harmony 10.1, uma alteração feita no conector Cherwell no Studio significa que ele não é mais compatível com agentes 10.0.

  • Solução alternativa: se usar o conector Cherwell, atualize para agentes 10.1 ou superior.