Meraki for Data Enrichment
Last updated
Last updated
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 .
This article will explain how to create the Meraki integration for data enrichment. The basic steps are:
Check the .
Get your .
Set up the in ThousandEyes.
Set up the in ThousandEyes.
For more information about how connector/operation (2.0) integrations work, see .
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.
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 .
Generate or retrieve your Meraki Dashboard API key. See Meraki’s documentation for more information.
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.
Go to Manage > Integrations.
Select the Integrations 2.0 tab.
On the Connectors tab, click + New Connector.
An Add Connector side panel opens.
Select Generic Connector.
In the resulting Add New Connector screen, select Meraki from the Preset Configurations dropdown menu.
This prefills the Custom Headers field with “X-Cisco-Meraki-API-Key”.
Give the integration a unique name in the Name field.
In the Target field, type in https://api.Meraki.com/api/v1/organizations.
Click Save & Assign Operation.
If the connector is configured correctly, you will see a popup in the bottom right alerting you that it saved successfully.
This also opens the Manage Operations panel.
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.
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.
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.
Give the operation a unique name and ensure the toggle is set to Enable.
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.
This also opens the Manage Connector panel.
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.
Click Save.
Your new connector and operation now appear in the Operations tab with the status of Pending.
You can also find the linked connector and operator from the Connectors tab.
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.
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.
Go back to Manage > Integrations > Integrations 2.0 > Operations to view your new integration status.
You edit connectors and operations in the same way on their corresponding tabs.
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.
Change any of the fields in the side panel and click Save.
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.
If your connector or operation is not yet linked, you can also click the Manage button to add an assignment.
You delete connectors and operations in the same way on their corresponding tabs, but you cannot delete them both at the same time.
Click Delete on the vertical ellipsis at the end of the row of the connector or operation you want to delete.
A confirmation dialog pops up to inform you that this action cannot be undone.
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.
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.
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.
Agent details show no data with “You do not have the permission to view the details”
Type or paste the Dashboard API Key from into the field next to the Custom Headers.
If you have come to the Operations tab from step 11 of , select Meraki Data Enrichment from the panel.
If you just created a connector, check the box next to the connector you created from steps 1-9 of .
Follow steps 4-10 of to set up your new connector.
Now that you have set up your integration, read about , or go straight to your to see your new data filtering through.
Ensure that the user account used for setting up the integration has enabled the Meraki Early Access API. For instructions, see the .
