Cisco Meraki Poller

The Cisco Meraki Poller microservice polls topology and metric data from Cisco Meraki devices by API using an API key.

Cisco Meraki has an API rate limited to five calls per second per organization.

This microservice is part of the Discovery microservice pipeline. See Understanding the Discovery Pipeline in Unified Assurance Concepts for conceptual information.

You can enable redundancy for this microservice when you deploy it. See Configuring Microservice Redundancy for general information.

Cisco Meraki Poller Prerequisites

Before deploying the Cisco Meraki Poller microservice, confirm that the following prerequisites are met:

  1. A microservice cluster is set up. See Microservice Cluster Setup.

  2. The following microservices are deployed:

  3. (Optional) You have created a Kubernetes secret containing the proxy certificates by running the following command as the assure1 user:

    export NAMESPACE=<namespace>
    a1k create secret generic meraki-proxy-secret --from-file=<PROXY_CA_FILE> --from-file=<PROXY_CRT_FILE> --from-file=<PROXY_KEY_FILE> -n $NAMESPACE 
    

    where <namespace> is the namespace where you are deploying the microservice. The default namespace is a1-zone1-pri, but you can change the zone number and, when deploying to a redundant cluster, change pri to sec.

    You can optionally use a different name for the secret files. If you do so, set them in the configData.PROXY_CA_FILE, configData.PROXY_CRT_FILE and configData.PROXY_KEY_FILE configuration parameters when you deploy the microservice.

Deploying Cisco Meraki Poller

To deploy the microservice, run the following commands:

su - assure1
export NAMESPACE=<namespace>
export WEBFQDN=<webFQDN> 
a1helm install <microservice-release-name> assure1/cisco-meraki-poller -n $NAMESPACE --set global.imageRegistry=$WEBFQDN

In the commands:

You can also use the Unified Assurance UI to deploy microservices. See Deploying a Microservice by Using the UI for more information.

Changing Cisco Meraki Poller Configuration Parameters

When running the install command, you can optionally change default configuration parameter values by including them in the command with additional --set arguments. You can add as many additional --set arguments as you need.

For example:

Default Cisco Meraki Poller Configuration

The following table describes the default configuration parameters found in the Helm chart under configData for the Cisco Meraki Poller microservice.

Name Default Value Possible Values Notes
LOG_LEVEL INFO FATAL, ERROR, WARN, INFO, DEBUG Logging level used by application.
PULSAR_MERAKI_DISCOVERY_OVERRIDE "" Text, 255 characters Cisco Meraki discovery request pulsar topic.
PULSAR_MERAKI_DISCOVERY_CALLBACK_OVERRIDE "" Text, 255 characters Cisco Meraki discovery callback request pulsar topic.
STREAM_OUTPUT_METRIC persistent://assure1/metric/sink Text, 255 characters Metric sink topic path.
REDUNDANCY_INIT_DELAY 20 Integer The number of seconds the secondary microservice wait for the primary microservice to start
REDUNDANCY_POLL_PERIOD 5 Integer The number of seconds between status checks from the secondary microservice to the primary microservice.
REDUNDANCY_FAILOVER_THRESHOLD 4 Integer The number of times the primary microservice must fail checks before the secondary microservice becomes active.
REDUNDANCY_FALLBACK_THRESHOLD 1 Integer The number of times the primary microservice must succeed checks before the secondary microservice becomes inactive.
PROXY_INSECURE_SKIP_VERIFY true Boolean When set to true, certificate validation will be skipped.
PROXY_USE_CERTS false Boolean When set to true, custom TLS certificates will be used while connecting to Cisco Meraki API.
PROXY_CA_FILE "proxyCA.crt" String Custom filename for proxy TLS CA Bundle.
PROXY_CRT_FILE "proxy.crt" String Custom filename for proxy certificate file.
PROXY_KEY_FILE "proxy.key" String Custom filename for proxy key file.