meraki_quick_check.py

""" Meraki Quick Check """

# Define Python modules
import os
import tabulate
import meraki

# Set Meraki API Key via env variable or input if not set
api_key = os.environ.get('YOUR_MERAKI_API_KEY') or input('\nEnter your Meraki API key: ')

# Set Meraki Dashboard API call, send logs to log folder and omit log output on console
dashboard = meraki.DashboardAPI(api_key, log_path="logs", print_console=False)

# Get all organizations
orgs = dashboard.organizations.getOrganizations()

# Define table headers and values for organizations
headers = ["No.", "Org Name", "Org ID"]
table = []

# If more than one organization then get all org data and print table
i = 0
if len(orgs) > 0:
    print('\nYour API Key grants access to the following organizations:\n')
    for org in orgs:
        org_name = orgs[i]['name']
        org_id = orgs[i]['id']
        i += 1

        # Add all organization data to table row and add row to table
        row = [org_name, org_id]
        table.append(row)

    # Print table using the received organization data
    print(tabulate.tabulate(table, headers=headers, tablefmt='fancy_grid', showindex=True))

    org_number = int(input('\nChoose one number ID from list: '))

# Else choose the only organization available
else:
    org = orgs[0]

# Get organization details and assign variables

org_id = table[org_number][1]
org_name = table[org_number][0]

# Get list of networks for organization
network_list = dashboard.organizations.getOrganizationNetworks(org_id)
print(f'\nYour organization \"{org_name}\" with ID {org_id} includes the following networks:\n')

# Define table headers and values for networks
headers = ['No.', 'Network Name', 'Network ID', 'Devices', 'Clients last 24h', 'Traffic last 24h']
table = []

# Iterate through network_list and assign network variables
for network in network_list:
    network_id = network['id']
    network_name = network['name']

    # Get online and offline clients for a network
    clients_online = len(dashboard.networks.getNetworkClients(
        network_id, total_pages='all', statuses='Online'))
    clients_offline = len(dashboard.networks.getNetworkClients(
        network_id, total_pages='all', statuses='Offline'))
    clients = f'{clients_online} Online / {clients_offline} Offline'

    # Get devices of a network for each device model
    devices_list = dashboard.networks.getNetworkDevices(network_id)

    # Set device model variables to zero
    devices_mx = 0
    devices_ms = 0
    devices_mr = 0

    # Iterate through device list and count devices per model
    i = 0
    for device in devices_list:
        device = devices_list[i]

        if "MX" in device['model']:
            devices_mx += 1

        if "MS" in device['model']:
            devices_ms += 1

        if "MR" in device['model']:
            devices_mr += 1

        i+=1

    devices = f"{devices_mx} MX(s), {devices_ms} MS(s), {devices_mr} MR(s)"

    # Get network traffic for a network for the last 24h
    try:
        traffic_all = dashboard.networks.getNetworkTraffic(network_id, timespan=86400)
        i = 0
        traffic_sum = 0
        for traffic in traffic_all:
            traffic = traffic_all[i]['recv'] + traffic_all[i]['sent']
            traffic_sum += traffic
            i += 1
        traffic_sum = f"{traffic_sum} bytes"

    # Set traffic sum to n/a in case traffic analysis is not activated on network
    except meraki.exceptions.APIError:
        traffic_sum = "n/a"

    # Add all network data to table row and add row to table
    row = [network_name, network_id, devices, clients, traffic_sum]
    table.append(row)

# Print table using the received network data
print(tabulate.tabulate(table, headers=headers, tablefmt="fancy_grid", showindex=True))