# meraki-naemon

Python3 Script for pulling Meraki device info into Nagios & Nagios-derived monitoring systems

usage: meraki_api.py [-h] -k API_KEY -d {switch,ap} -t {license,uplink,port,latency,ssid,failconn,connassoc,connauth,conndhcp,conndns,connsucc,clients}
                     [-o ORGID] [-n NETWORKID] [-s SERIAL] [-w SSID] [-p PORT]

Information from Meraki Dashboard API (https://api.meraki.com/api/v0). For full documentation on the Meraki Dashboard API please see:
- https://dashboard.meraki.com/api_docs
- https://documenter.getpostman.com/view/897512/meraki-dashboard-api/2To9xm

**Required Arguments**:

  -k API_KEY, --api-key API_KEY
  
                        API key obtained from Meraki Dashboard admin account
                        
  -d {switch,ap}, --device {switch,ap}
  
                        Device type to be queried (Wireless AP or Switch)
                        
  -t {license,uplink,port,latency,ssid,failconn,connassoc,connauth,conndhcp,conndns,connsucc,clients}, --type {license,uplink,port,latency,ssid,failconn,connassoc,connauth,conndhcp,conndns,connsucc,clients}

**Supplemental arguments**:

  -o ORGID, --orgid ORGID
  
                        Organization ID
                        
                        API Call (retrieve orgid[s]): GET /organizations
                        
  -n NETWORKID, --networkid NETWORKID
  
                        Network ID
                        
                        API Call (retrieve network id[s]): GET /organizations/<organization ID>/networks
                        
  -s SERIAL, --serial SERIAL
  
                        Meraki Device Serial Number, e.g., ABCD-1234-EF56
                        
                        API Call (retrieve serial number[s]): GET /networks/<network id>/devices
                        
  -w SSID, --ssid SSID
  
                        Specify the SSID by integer, e.g., 0
                        
                        API Call (retrieve SSID number[s]): GET /networks/<network id>/ssids
                        
  -p PORT, --port PORT  
  
                        Switch port number
                        
                        API Call (retrieve stats for all switch ports): GET /devices/<serial number>/switchPorts


**EXPLANATION & USAGE**
                        
    I. All devices
        license: Expiration of Meraki device license
        	-t license -o <organization id>
        uplink:	Status of Meraki device connection to the cloud
        	-t uplink -n <network id> -s <serial number>

    II. Switch Options
        port: Get status on an individual switchport
        	-t port -s <serial number> -p <port number>

    III. AP Options
        latency: Latency stats over the past hour per AP
        	-t latency -n <network id> -s <serial>
        ssid: Status of configured SSID(s)	
        	-t ssid -n <network id> -w <#>
        failconn: Number of failed connections over the past hour
        	-t failconn -n <network id>
        connassoc, connauth, conndhcp, conndns, connsucc: Connection stats per AP over the past hour at different stages
            -t [connassoc, connauth, conndhcp, conndns, connsucc] -n <network id> -s <serial number>
        clients: Number of connected clients per AP within the past 2 hours
                -t clients -s <serial number>