---
title: Workato
description: Gain insights into Workato Job activity and Recipe/Connection status.
breadcrumbs: Docs > Integrations > Workato
---

# Workato
Integration version1.0.0Workato Overview
## Overview{% #overview %}

[Workato](https://www.workato.com) provides a platform for enterprise automation and integration so you can connect, integrate, and automate your applications, data, and processes end-to-end.

The Workato integration collects [jobs](https://docs.workato.com/en/recipes/jobs.html#viewing-job-reports), logs (recipe execution), and status metrics (connection and recipe state), sending them to Datadog for detailed analysis. The logs are parsed and enriched for efficient searching, while the metrics provide insights into operational status.

The integration includes a dashboard that shows job execution status and duration, making it easier to monitor and understand trends and issues.

## Setup{% #setup %}

### Generate API credentials in Workato{% #generate-api-credentials-in-workato %}

1. Log in to [Workato](https://app.workato.com/users/sign_in) as an administrator.
1. Navigate to the **Workspace Admin** > **API Clients** tab.
1. (Create a Client Role with sufficient permission) Click **Client Roles** tab.
1. Click **+ Add client role**.
   1. Check the following boxes to allow minimal read access:

| Section  | Permission                                |
| -------- | ----------------------------------------- |
| Projects | Project Assets > List Projects            |
| Projects | Project Assets > List Folders             |
| Projects | Connections > List                        |
| Projects | Recipes > List                            |
| Projects | Recipes > Get job counts for recipes      |
| Projects | Recipes > Get details                     |
| Projects | Recipe Versions > List                    |
| Projects | Jobs > List                               |
| Projects | Jobs > Get job                            |
| Admin    | Environment Management > Tags > List tags |

   1. Edit the role name, and click **Save changes**.
1. Select the **API Clients** tab.
1. Click **+ Add API Client**, and then enter the required information:
   1. Under **Name**, enter a descriptive and identifiable client name.
   1. Choose the newly created Client Role from the dropdown, or ensure the selected role has `LIST` and `GET DETAILS` permissions on all Workato Resources.
   1. If the Environments feature is enabled, choose the Environment to which this client has access.
   1. Choose between *Selected Projects* or *All Projects* from the **Project access** drop-down menu.
   1. Leave the **Allowed IPs** text box blank to allow access from any IP.
1. Click **Create Client**, and copy the API token for later use.

### Connect your Workato Account to Datadog{% #connect-your-workato-account-to-datadog %}

1. Add your Access Token
| Parameters | Description                                  |
| ---------- | -------------------------------------------- |
| API Token  | Token generated for your Workato API Client. |
1. Click the Save button to save your settings.

## Data Collected{% #data-collected %}

### Logs{% #logs %}

The Workato integration collects and forwards job execution results to Datadog.

### Metrics{% #metrics %}

|  |
|  |
| **workato.connections.failure**(gauge) | Whether a Workato connection is in a failed state                   |
| **workato.recipes.failure**(gauge)     | Whether a Workato recipe is offline due to configuration or failure |
| **workato.recipes.task\_count**(gauge) | The lifetime task count for recipe                                  |

### Service Checks{% #service-checks %}

Workato does not include any service checks.

### Events{% #events %}

Workato does not include any events.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://app.datadoghq.com/account/settings/agent/latest).