# Meraki for Data Enrichment

With the Meraki integration into ThousandEyes, you gain the ability to view your Meraki local area network (LAN) data within your test’s path or segment visualizations, enabling you to resolve problems more quickly with complete information no matter where your journey begins. For more information about how Meraki data enrichment can work for you, see [Using the Path Visualization View](https://docs.thousandeyes.com/product-documentation/internet-and-wan-monitoring/path-visualization/using-the-path-visualization-view#meraki-data-enrichment).

This article will explain how to create the Meraki integration for data enrichment. The basic steps are:

1. Check the [prerequisites](#prerequisites).
2. Get your [Meraki API key](#steps-within-meraki).
3. Set up the [connector](#setting-up-the-meraki-connector) in ThousandEyes.
4. Set up the [operation](#setting-up-the-meraki-operation) in ThousandEyes.

For more information about how connector/operation (2.0) integrations work, see [Integrations](https://docs.thousandeyes.com/product-documentation/integration-guides).

## Prerequisites

To use the features described in this document, you must have both of the following:

* An active Meraki license and account.
* An active account for ThousandEyes.

### ThousandEyes Permissions

To create the integration, you must have an Organization Admin or Account Admin role in the ThousandEyes platform. For more information about ThousandEyes roles, see [Role-Based Access Control, Explained](https://docs.thousandeyes.com/product-documentation/user-management/rbac/role-based-access-control-explained).

## Steps within Meraki

1. Generate or retrieve your Meraki Dashboard API key. See Meraki’s [Generate API Key](https://documentation.meraki.com/General_Administration/Other_Topics/Cisco_Meraki_Dashboard_API#Generate_API_Key) documentation for more information.

## Steps within ThousandEyes

### Setting Up the Meraki Connector

The Meraki integration for data enrichment is one of our connector/operation (2.0) integrations, meaning it is formed by linking a connector to an operation. The following steps describe how to set up the connector.

1. Go to **Manage > Integrations**.
2. Select the **Integrations 2.0** tab.

   ![Integrations tabs](/files/QUCi0u5YYL9Wa6pWN0WG)
3. On the **Connectors** tab, click **+ New Connector**.

   ![New connector button](/files/hbtRH4g9outUMJQRuM8D)

   * An **Add Connector** side panel opens.
4. Select **Generic Connector**.

   ![Generic Connector card](/files/IN8VaTkBOsEqY9M0Ba9g)
5. In the resulting **Add New Connector** screen, select Meraki from the **Preset Configurations** dropdown menu.

   ![Preset Configuration dropdown showing Meraki option](/files/OrUmfG3wKpU8XaZ6EFz3)

   * This prefills the **Custom Headers** field with “X-Cisco-Meraki-API-Key”.
6. Give the integration a unique name in the **Name** field.
7. In the **Target** field, type in <https://api.Meraki.com/api/v1/organizations>.
8. Type or paste the Dashboard API Key from [Steps within Meraki](#steps-within-meraki) into the field next to the **Custom Headers**.
9. Click **Save & Assign Operation**.

   ![Completed connector screen with Save & Assign button](/files/fUVHtzKDzaNzeKLAklZv)

   * If the connector is configured correctly, you will see a popup in the bottom right alerting you that it saved successfully.

   ![Popup for connector saved successfully](/files/zBTa9gKRsJMKM8bdxNOl)

   * This also opens the **Manage Operations** panel.

   ![Manage operations panel](/files/DXDWFqgJ6CCHsBVWQM01)
10. If you have already configured an operation you want to link the connector to, check the box next to the operation from the **Select operations** list.

    ![Operation checkbox](/files/nIhKtZQMqv5MZtNSR8Zh)

{% hint style="info" %}
Currently, you are only able to select one operation to link to one connector.
{% endhint %}

11. If you want to link to a new operation that’s not listed, click **+ New Operation** in the top right.

    * This switches you to the **Operations** tab and opens the **Add Operation** panel.

    ![Add Operation panel](/files/kXgrcqkeYFPsYfLTcpuY)

### Setting Up the Meraki Operation

12. If you have come to the **Operations** tab from step 11 of [Setting Up the Meraki Connector](#setting-up-the-meraki-connector), select **Meraki Data Enrichment** from the panel.
    * If you are setting up a new operation without having first set up a new connector, go to **Manage > Integrations > Integrations 2.0 > Operations**.
    * Select **+ New Operation**.
      * This opens the **Add Operation** panel.
      * Select **Meraki Data Enrichment** from the panel.
13. Give the operation a unique name and ensure the toggle is set to Enable.

    ![Add New Operation screen with Enable toggled on](/files/xIYaA9LuoS6K9O7OkgKO)
14. Click **Save & Assign Connector**.

    * If the operation is configured correctly, you will see a popup in the bottom right alerting you that it saved successfully.

    ![Popup for operation successfully saved](/files/squCyb96DvohTQL4eins)

    * This also opens the **Manage Connector** panel.

    ![Manage Connector panel](/files/4qdRUUUCppqFADLsZZsV)
15. If you just created a connector, check the box next to the connector you created from steps 1-9 of [Setting Up the Meraki Connector](#setting-up-the-meraki-connector).
    * If you are creating the operation first, either check the box next to the connector you want to link to from the list or click **+ New Connector** in the top right to create a new connector.
      * Clicking **+ New Connector** takes you to the **Connector** tab and opens the **Add Connector** panel.
      * Follow steps 4-10 of [Setting Up the Meraki Connector](#setting-up-the-meraki-connector) to set up your new connector.
16. Click **Save**.

    * Your new connector and operation now appear in the **Operations** tab with the status of Pending.

    ![Pending status for operation](/files/L6XXLYA1heg3gpFdlnlo)

    * You can also find the linked connector and operator from the **Connectors** tab.

    ![Linked integration on Connectors tab](/files/NF4qUiAF8aQQ9v47C9up)

### Updating the Integration Status

To update your integration's status from Pending to either Connected or Failed, you need to go to your test view and "use" the integration once.

17. Go to **Network & App Synthetics > Views** and navigate to any test involving a Meraki MX Agent, and which features path visualization, such as an Agent to Server test.

    * In the **Path Visualization**, hover over any node with the Meraki symbol; this triggers an API call to receive the additional node data as verified by Meraki. This initial API call causes the integration status to update from Pending to either Connected or Failed.

    ![Node with agent details including those verified by Meraki](/files/pzgkdhuPIZYTAqJbbeOK)
18. Go back to **Manage > Integrations > Integrations 2.0 > Operations** to view your new integration status.

    ![Connected status for operation](/files/tBSdVH0zQdlkuWJ5aZ2G)

## Editing the Meraki Data Enrichment Integration

You edit connectors and operations in the same way on their corresponding tabs.

1. Click anywhere on the row of the connector or operation you want to edit.

   * Alternatively, click **Edit** on the vertical ellipsis at the end of the row.

   ![Edit dialog](/files/avYiVqlqLxdM3ybAqxfW)
2. Change any of the fields in the side panel and click **Save**.
3. To update the corresponding connector or operation, click **Manage Operations** if you are on the connector tab or **Assign Connector** if you are on the operations tab.

   ![Assign Connector dialog](/files/85cyIJMh6kHFAZQXF4PR)

   * If your connector or operation is not yet linked, you can also click the **Manage** button to add an assignment.

   ![No assigned operation message with Manage button](/files/PjK6v33fc7avKEx44xBN)

## Removing the Meraki Data Enrichment Integration

You delete connectors and operations in the same way on their corresponding tabs, but you cannot delete them both at the same time.

1. Click **Delete** on the vertical ellipsis at the end of the row of the connector or operation you want to delete.

   ![Delete dialog](/files/nQG3YRz4jszXpxKgmxEC)

   * A confirmation dialog pops up to inform you that this action cannot be undone.

   ![Delete confirmation dialog](/files/7jbMzvCHDvxFkv81tv4m)
2. If you wish to continue, click **Delete** again.

   * When you delete a linked connector or operation, the remaining part of the integration will update to show that it is now missing an assignation.

   ![No assigned operation message](/files/PjK6v33fc7avKEx44xBN)

   * To delete the whole integration, delete the second part of the integration, too.
   * Alternatively, you can delete one part of the integration and assign the remaining part to a different connector or operation.

## Troubleshooting Meraki Data Enrichment

1. Status stuck in “Pending”
   * ThousandEyes retrieves data from Meraki only at the point of an API call, unlike a streaming service which is constantly receiving data regardless of user interaction. The integration only updates its status after the first API call is made. Therefore, you must go to **Network & App Synthetics > Views,** and find a test featuring both a Meraki MX Agent and path visualization, such as an Agent to Server test. Hover over any Meraki-branded node in the **Path Visualization** section to generate an API call. Once you have "used" the integration for the first time, the status will update to either Connected or Failed.

Now that you have set up your integration, read about [what it enables](https://docs.thousandeyes.com/product-documentation/internet-and-wan-monitoring/path-visualization/using-the-path-visualization-view#meraki-data-enrichment), or go straight to your [views](https://app.thousandeyes.com/view/cloud-and-enterprise-agents) to see your new data filtering through.

2. Agent details show no data with “You do not have the permission to view the details”
   * Ensure that the user account used for setting up the integration has enabled the Meraki Early Access API. For instructions, see the [Early Access API documentation](https://developer.cisco.com/meraki/api-v1/api-reference-early-access-overview/).

## Frequently Asked Questions

**Do I need to add the ThousandEyes IP address for data integration?**

If your Meraki organization has login IP range restrictions set through the security control options, you will need to add the ThousandEyes IP address to allow for data integration. For instructions, see the Meraki documentation's [Organization Settings](https://documentation.meraki.com/General_Administration/Organizations_and_Networks/Organization_Menu/Organization_Settings) section.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thousandeyes.com/product-documentation/integration-guides/custom-built-integrations/meraki-data-enrichment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.