# Meraki discovery
# Introduction
The purpose of this plugin is to monitor meraki devices, appliance, switch and wireless.
The plugin connects with the rest api of Meraki, in order to obtain all the metrics.
# Pre rrequisites
- **The system running the plugin must have connectivity and be able to remotely reach the meraki switches.**
# Parameters
**Parámeters**
--conf
Path to configuration file
**Archivo de configuración (--conf)**
```
base_url = API connection url
bearer_token = Bearer token needed for authentication
organization = ID of the organization in which the networks will be scanned.
network = Meraki network or regexp pattern; all networks that match this will be monitored. Use `.*` to monitor all of them.
location = Secondary groups added to the agent
api_url = Url of the pandora api
api_user = User of the pandora api
api_pass = Password of the pandora api
api_user_pass = Password of the user of the pandora api
agents_group_name = Group for the agents
agent_prefix = Prefix for the agents
module_prefix = Prefix for the modules
interval_monitoring = Monitoring interval for switch port statistics.
agentname_hostname = Activate with 1 to use the hostname as agent name. With 0 the agent name will have the serial code.
scan_appliance = Enable to monitor Appliance type devices
scan_switch = Enable to monitor switch type devices
scan_wireless = Enable to monitor wireless type devices
scan_traffic_appliance_network = Enable monitoring of appliance device traffic at the Network level.
scan_cellular_gateway = Enable to monitor cellular gateway devices
tentacle_address = Tentacle address
tentacle_port = Tentacle portPath to configuration file
```
# Manual execution
The format of the plugin execution is as follows:
```
./pandora_meraki --conf < path to the configuration file >
```
For example:
```
./pandora_meraki --conf /usr/share/pandora_server/util/plugin/meraki.conf
```
The execution will return an output in JSON format with information about the execution, and will generate an XML file for each monitored agent that will be sent to the Pandora FMS server by the transfer method indicated in the configuration.path to the configuration file.
# Discovery
This plugin can be integrated with Pandora FMS Discovery.
To do so, you must load the “.disco” package that you can download from the Pandora FMS library:
[https://pandorafms.com/library/](https://pandorafms.com/library/)
Once loaded, Horizon environments can be monitored by creating Discovery tasks from the Management > Discovery > App section.
The following minimum data will be requested for each task:
- **Token:** Token bearer required for authentication.
- **Url:** API connection Url
- **Organization:** ID of the organization in which the networks will be scanned.
- **Network:** Meraki network or regexp pattern; all networks that match this will be monitored. Use `.\*` to monitor all of them.
- **Location:** Secondary groups added to the agent
- **Tentacle IP:** Tentacle address
- **Tentacle port:** Tentacle port
[](https://pandorafms.com/guides/public/uploads/images/gallery/2026-04/image.png)
On the next page we will be asked for the following :
[](https://pandorafms.com/guides/public/uploads/images/gallery/2026-04/Fcecaptura-desde-2026-04-08-14-34-56.png)
- Agent prefix: Prefix for agents
- Module prefix: Prefix for modules
- Interval monitoring: Monitoring interval for switch port statistics.
- API Url: Url of pandora api
- API Password: Password of pandora api
- API User: Pandora api user
- API User password: Pandora api user password
- Name Agent Hostname: Enabled will use the devices hostname as the agent name. Without activating the serial code.
- Scan Appliances: Enable to monitor Appliance type devices
- Scan Switches: Enable to monitor switch type devices
- Scan Wireless: Enable to monitor wireless type devices.
- Scan Appliance Traffic Network**:** Enabled will use the devices hostname as the agent name. Without activating the serial code.
- Scan cellularGateway:Enable to monitor cellularGateway type devices.
The successfully completed tasks will have an execution summary with the following information:
- Total agents : Total number of agents generated by the task.
- Total wireless agents: Total number of wireless agents generated by the task.
- Total appliance agents: Total number of Appliance agents generated by the task.
- Total cellularGateway agents:
- Total network appliance traffic agents:
- Total switches agents: Total number of Switch agents generated by the task:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2026-04/captura-desde-2026-04-08-14-26-56.png)
# Agent and modules generated by the plugin
The plugin execution will create the following agents and modules:
One agent for each Appliance type deviceThe system running the plugin must have connectivity and be able to remotely reach the meraki switches.
- `status`
- `perfScore` *(if present)*
- `Uplink _ifOperStatus` *(one for each interface detected)*
- `uplink_sent_bytes`
- `uplink_recv_bytes`
One agent for each Switch type deviceOne for each port
- `status`
- `Port _ifOperStatus` *(one for each port)*
- `Port _ifOutOctets` *(one for each port)*
- `Port _ifInOctets` *(one for each port)*
One agent for each Wireless device
- `status`
- `totalKbps` *(if available)*
- `sentKbps` *(if available)*
- `receivedKbps` *(if available)*
- `clientCount` *(if available)*
An agent with network-level traffic data from Appliance devices.
- `Traffic appliance total_sent`
- `Traffic appliance total_recv `
- `Traffic appliance total_clients `