Connectors → Cisco Meraki

About Cisco Meraki

Cisco Meraki is a cloud IT management software that provides users with a scalable and secure solution that can help them create and control their networks. Cisco Meraki’s products include wireless, switching, security, enterprise mobility management and security cameras, all centrally managed from the web.

Cisco Meraki Connector

The Incorta Cisco Meraki connector uses the Cisco Meraki REST API to extract data for the following Meraki entities:

  • Organizations
  • Devices
  • Device Clients
  • Device Switch Ports
  • Networks
  • Network Appliance Ports
  • Network Content Filtering
  • Network Device Ports (Network Device LLDP and CDP Ports)
  • Network Device Uplinks
  • Network Security Events
  • Network Traffic

The Cisco Meraki connector supports the following Incorta specific functionality:

FeatureSupported
Chunking
Data Agent
Encryption at Ingest
Incremental Load✔*
Multi-Source
OAuth
Performance Optimized
Remote
Single-Source
Spark Extraction
Webhook Callbacks

*Incremental loading is supported for the following Cisco Meraki entities only: Device Clients, Network Device Ports, Network Security Events, and Network Traffic.

Deployment Steps

Important

Deployment of the Cisco Meraki connector requires a restart of the entire Incorta cluster, including the CMC, analytics and loader services.

The Cisco Meraki connector is an external connector, which means you deploy it as a plugin to the Incorta platform and upgrade it separately from upgrading the Incorta platform itself.

Here are the steps to deploy incorta.connector.meraki.jar to the extensions directory:

  • Download the Cisco Meraki JAR file from the latest version of your Incorta customer release distribution (incorta.connector.meraki.jar)
  • Create the meraki directory in {path to IncortaNode}/extensions/connectors: $ mkdir {path to IncortaNode}/extensions/connectors/meraki
  • Copy the Cisco Meraki connector JAR file to {path to IncortaNode}/extensions/connectors/meraki
  • Create the meraki directory in {path to cmc}/extensions/connectors: $ mkdir {path to cmc}/extensions/connectors/meraki
  • Copy the Cisco Meraki connector JAR file to {path to cmc}/extensions/connectors/meraki
  • Restart the entire Incorta cluster (CMC, analytics, and loader services)

Steps to connect Cisco Meraki and Incorta

To connect Cisco Meraki and Incorta, here are the high level steps, tools, and procedures:

Create an external data source

Here are the steps to create a external data source with the Cisco Meraki connector:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Data.
  • In the Action bar, select + NewAdd Data Source.
  • In the Choose a Data Source dialog, in Application, select Cisco Meraki.
  • In the New Data Source dialog, specify the applicable connector properties.
  • To test, select Test Connection.
  • Select Ok to save your changes.

Cisco Meraki connector properties

Here are the properties for the Cisco Meraki connector:

PropertyControlDescription
Data Source Nametext boxEnter the name of the data source
API Keytext boxEnter the API key required to access the data
Maximum number of API requests per secondtext boxEnter a value between 1 and 5
Maximum number of retriestext boxEnter the number of times the connector should resend the same request upon failure due to the HTTP 429 - Too many requests error
Organizations Filtertext boxA comma separated list of organization IDs that limits the number of requests and data loaded, for example:
549236, 438125

Create a schema with the Schema Wizard

Here are the steps to create a Cisco Meraki schema with the Schema Wizard:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the Action bar, select + New → Schema Wizard
  • In (1) Choose a Source, specify the following:
    • For Enter a name, enter the schema name.
    • For Select a Datasource, select the Cisco Meraki external data source.
    • Optionally create a description.
  • In the Schema Wizard footer, select Next.
  • In (2) Manage Tables, in the Data Panel, first select the name of the Data Source, and then check the Select All checkbox.
  • In the Schema Wizard footer, select Next.
  • In (3) Finalize, in the Schema Wizard footer, select Create Schema.

Create a schema with the Schema Designer

Here are the steps to create a Cisco Meraki schema using the Schema Designer:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the Action bar, select + New → Create Schema.
  • In Name, specify the schema name, and select Save.
  • In Start adding tables to your schema, select Cisco Meraki.
  • In the Data Source dialog, specify the Cisco Meraki table data source properties.
  • Select Add.
  • In the Table Editor, in the Table Summary section, enter the table name.
  • To save your changes, select Done in the Action bar.

Cisco Meraki table data source properties

For a schema table in Incorta, you can define the following Cisco Meraki specific data source properties as follows:

PropertyControlDescription
Typedrop down listDefault is Cisco Meraki
Data Sourcedrop down listSelect the Cisco Meraki external data source
Entitydrop down listSelect the Cisco Meraki entity to add to the schema
Timespan in Secondstext boxThis property appears when an incremental loading supported entity is selected. Enter the lookback period. The maximum value is 2592000 seconds (30 days).
Page Sizetext boxThis property appears when an incremental loading supported entity is selected. Enter the number of records in a page for the REST API request.
IncrementaltoggleEnable incremental loading for the schema table
Incremental Loading Starting Timedrop down listThis property appears when the Incremental toggle is enabled. Select the incremental loading starting time option.
CallbacktoggleEnables the Callback URL field
Callback URLtext boxThis property appears when the Callback toggle is enabled. Specify the URL.

Incremental Loading Starting Time options

  • Bounded by timespan: This option will fetch all events within the lookback period specified in Timespan in Seconds.
  • Last load time: This option will fetch all events generated since the last load, and is bounded by the lookback period.

View the schema diagram with the Schema Diagram Viewer

Here are the steps to view the schema diagram using the Schema Diagram Viewer:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the list of schemas, select the Cisco Meraki schema.
  • In the Schema Designer, in the Action bar, select Diagram.

Cisco Meraki schema diagram

The following is an example schema for an external data source that utilizes the Cisco Meraki connector:

Load the schema

Here are the steps to perform a Full Load of the Cisco Meraki schema using the Schema Designer:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the list of schemas, select the Cisco Meraki schema.
  • In the Schema Designer, in the Action bar, select Load → Load Now → Full.
  • To review the load status, in Last Load Status, select the date.

Explore the schema

With the full load of the Cisco Meraki schema complete, you can use the Analyzer to explore the schema, create your first insight, and save the insight to a new dashboard.

To open the Analyzer from the schema, follow these steps:

  • In the Navigation bar, select Schema.
  • In the Schema Manager, in the List view, select the Cisco Meraki schema.
  • In the Schema Designer, in the Action bar, select Explore Data.