Com o acionador o Error Catcher, é possível invocar um coletor de erros definido ou personalizado para processar a falha de um acionador, tarefa ou condição de borda identificado na sua integração.
Adicionar um acionador do Error Catcher
Para adicionar um acionador do Error Catcher à sua integração, siga estas etapas:
No console Google Cloud , acesse a página Integração de aplicativos.
A página Lista de integrações aparece com todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração ou clique em Criar integração para criar uma nova.
Caso você esteja criando uma nova integração, siga estas etapas:
Insira um nome e uma descrição no painel Criar integração.
Selecione uma região para a integração.
Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel infoResumo da integração na barra de ferramentas de integração.
Clique em Criar.
A integração recém-criada é aberta no editor de integração.
Na barra de navegação do editor de integração, clique em Gatilhos para conferir a lista de acionadores disponíveis.
Clique e posicione o elemento de acionador Error Catcher no designer de integração.
Configurar o acionador do Error Catcher
Clique no elemento Gerenciador de erros no designer de integração para ver o painel de configuração do acionador.
A guia Configuração exibe o Código do coletor de erros, que é gerado automaticamente quando você adiciona o acionador ao designer de integração. Também é possível editar o código gerado automaticamente, se necessário. Nenhuma configuração adicional é necessária para esse gatilho.
Criar a lógica do coletor de erros
Depois de adicionar o acionador Error Catcher no designer de integração, você pode criar sua lógica personalizada de coletor de erros usando as tarefas disponíveis na Application Integration. Clique e coloque os elementos de tarefas de integração
desejados no designer de integração e conecte-os ao seu acionador Error Catcher.
Anexar o coletor de erros
Depois de criar sua lógica de coletor de erros personalizada, você pode usá-la para lidar com erros ou falhas de execução em ambos os níveis de tarefas e eventos. Para usar ou anexar um coletor de erros na sua integração principal, siga estas etapas:
Clique no gatilho ou na tarefa existente na sua integração principal para abrir o painel de configuração do gatilho ou da tarefa.
No painel de configuração, expanda a seção Tratamento de erros e acesse o Coletor de erros.
Clique em Selecionar coletor de erros e selecione o código do acionador do Error Catcher que você quer usar.
Um indicador vermelho aparece no respectivo acionador ou elemento de tarefa indicando que o elemento está anexado a um coletor de erros.
A imagem a seguir mostra um exemplo de fluxo de integração que usa o coletor de erros:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 UTC."],[[["\u003cp\u003eThe Error Catcher trigger allows you to define custom logic to handle failures in your integration at the trigger, task, or edge level.\u003c/p\u003e\n"],["\u003cp\u003eAdding the Error Catcher trigger involves placing it in the integration designer, after navigating to the integration editor and selecting the triggers panel.\u003c/p\u003e\n"],["\u003cp\u003eThe Error Catcher trigger has an auto-generated ID that can be edited, and this ID is unique, meaning no other Error Catcher trigger can share it.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating the Error Catcher trigger, you can build custom error-handling logic using the available tasks in Application Integration.\u003c/p\u003e\n"],["\u003cp\u003eTo attach the Error Catcher, you select the desired ID in the error handling section of a trigger or task in the main integration.\u003c/p\u003e\n"]]],[],null,["# Error catcher trigger\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nError catcher trigger\n=====================\n\n\nThe **Error Catcher** trigger lets you invoke an [error catcher](/application-integration/docs/error-catcher) that is defined or customized to handle the failure of an identified trigger, task, or edge condition in your integration.\n\nAdd an Error Catcher trigger\n----------------------------\n\nTo add an **Error Catcher** trigger in your integration, perform the following steps:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations**\n\n\n The **Integrations List** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, Click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create**.\n\n\n The newly created integration opens in the *integration editor*.\n4. In the *integration editor* navigation bar, click **Triggers** to view the list of available triggers.\n5. Click and place the **Error Catcher** trigger element in the integration designer.\n\nConfigure the Error Catcher trigger\n-----------------------------------\n\nClick the **Error Catcher** trigger element in the integration designer to view the trigger configuration\npane.\n\nThe **Configuration** tab displays the **Error catcher ID**, which is auto-generated when you add the trigger in your integration designer. You can optionally edit the auto-generated ID if needed. No further configuration is required for this trigger.\n| **Note:** Error catcher IDs are unique to each **Error Catcher** trigger, therefore you can't have more than one **Error Catcher** trigger with the same **Error catcher ID**.\n\n\u003cbr /\u003e\n\nCreate the error catcher logic\n------------------------------\n\n\nOnce you have added the **Error Catcher** trigger in the integration designer, you can create your custom [error catcher](/application-integration/docs/error-catcher) logic using the available tasks in Application Integration. Click and place the desired\n[integration tasks](/application-integration/docs/how-to-guides#configure-integration-tasks)\nelements in the integration designer and connect them with your **Error Catcher** trigger.\n\n\n### Attach the error catcher\n\nOnce you have created your custom error catcher logic, you can use it to handle the errors or execution failures at both, the [task](/application-integration/docs/error-catcher#task) and [event](/application-integration/docs/error-catcher#event) levels. To use or attach an error catcher in your main integration, perform the following steps:\n\n1. Click the existing trigger or task in your main integration to open the trigger or task configuration pane.\n2. In the configuration pane, expand the **Error handling** section and go to **Error catcher**.\n3. Click **Select error catcher** and select the **Error Catcher** trigger ID that you want to use.\n\n A red indicator appears on the respective trigger or task element indicating that the element is attached to an error catcher.\n\n| **Notes:**\n|\n| - You can't attach multiple error catchers to the same task or trigger in your main integration.\n| - Error catchers can't be nested. This means that you cannot invoke an Error catcher trigger using another Error catcher trigger in your integration.\n| - You cannot establish an edge connection between the tasks configured inside an error catcher and the tasks or triggers used in your main integration flow.\n\nThe following image shows a sample integration flow that uses error catcher:\n\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
