Newer
Older
[PACKAGE]: ../../raw/master/mkp/cisco_meraki-1.2.9-20240202.mkp "cisco_meraki-1.2.9-20240202.mkp"
[SDK]: ../../raw/master/mkp/MerkaiSDK-1.39.0-202311-10.mkp "MerkaiSDK-1.39.0-202311-10.mkpp"
This is an enhanched version of the build in Cisco Meraki special agent.
- adds sections
- Appliances uplinks
- Appliances VPNs
- Cellular devices uplinks
- Devices uplink info
- Switch ports status
- Wireless devices ethernet status
- Wireless devices SSIDs status
- adds an API cache (can be disabled)
- adds option to use the organisation id as host prefix (usfull to sort the host automatically in organisation specific folders)
- changed include sections option to excludeed sections
Monitors the status of Meraki appliance (i.e. MX series) uplinks.
Includes:
- uplink state (active, ready, not connected, failed)
- Network name
- internal/external IP address
- IP address assignment method
- H/A state / role
- DNS server primary/secondary
Monitor the status VPN of meraki MX appliances.
Includes:
- state (reachable, unreachable)
- type (Meraki VPN Peer, third party VPN Peer)
- mode (hub, )
- used uplinks
- local public IP
- peer IP address (if available)
Extends the existing device info inventory plugin by:
- adding host labels
- cmk/meraki: This label is set to "yes" for all Meraki devices
- cmk/meraki/device_type: This label is set to the Meraki product type to which the device belongs, such as "switch" or "wireless".
- cmk/meraki/net_id: This label is set to the network id the Meraki device belongs to.
- cmk/meraki/net_name: This label is set to the network name the Meraki device belongs to.
- cmk/meraki/org_id: This label is set to the organisation id the Meraki device belongs to.
- cmk/meraki/org_name: This label is set to the organisation name the Meraki device belongs to.
- extending the inventory by adding
- the manufacturer
- the network name
- moving the software part of the inventory to Software -> Applications -> Cisco Meraki Cloud -> Device Info
Extends the existing plugin by:
- adding upper levels for device last reported
- adding WATO to map device state to monitoring state
- adding a service to monitor power supplys
- adding found power supplys to the inventory
Adds uplink information under Networking -> Device uplinks to the inventory. This Includes
- Interface name
- Protocol (IPv4/IPv6)
- IP address
- Gateway
- Public address
- Assignment mode
</details>
<details><summary>Licenses Overview</summary>
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
Extends/changes the existing license overview plugin by
- changes Expiration date format from US (%b %d, %Y) to ISO (%Y-%m-%d)
- changes remaining time (WATO) from Age (Days, Hours, Minutes, Seconds) to Days only
- adds discovery rule for ITEM variant (Org Name/Org ID - this is the default, Org Name, Org ID) information missing in the item can be shown in the info line (default)
- adds ORG_ID, ORG_NAME to the Details
- adds Metrics for remaining time and # of licensed devices
- adds perfometer with remaining time and # of licensed devices
- adds WATO option for License state is not ok -> default to WARN
- adds licensed devices overview to the inventory
</details>
<details><summary>Networks</summary>
Adds Meraki Networks (Locations) to the inventory:
- Organisation ID
- Organisation Name
- Network ID
- Network Name
- Time Zone
- Product types
- Tags
- Notes
- Enrollment string
- Is bound to template
- URL
</details>
<details><summary>Wireless Devices Status</summary>
Monitors the state of Meraki SSIDs. Includes:
- Name
- State (enabled/disabled)
- Visible (yes/no)
- Broadcasting (yes/no)
- BSSID
- Band (2.4 GHz/5 GHz)
- Channel
- Channel width in MHz
- Power in dBm
</details>
<details><summary>Wirelss Ethernet Status</summary>
Monitors the ethernet port(s) of wireless devices. Includes:
- Speed in GBit/s
- Duplex (full/half)
- Power mode (full/ )
- AC state (connected/not connected)
- PoE state (connected/not connected)
- PoE standard
</details>
<details><summary>Organisation API</summary>
Monitors the state of the Meraki REST-API per organisation. Includes:
- Status (enabled/disabled)
- Organisation ID
- Organisation Name
</details>
<details><summary>Switch Port Status</summary>
</details>
---
### Download
* [Download latest mkp file][PACKAGE]
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
**Note**: before you update to a newer version, always check the [CHANGELOG](CHANGELOG). There migth be incompatible changes.
---
### Installation
You can install the package by uploading it to your CheckMK site and as site user run
```
mkp add PAKAGE_NAME.mkp
mkp enable PAKAGE_NAME VERSION
```
In the Enterprise/Free/Cloud edition of CheckMK you can use the GUI to install the package (_Setup_ -> _Extension Packages_ -> _Upload package_)
---
### Want to Contribute?
Nice ;-) Have a look at the [contribution guidelines](CONTRIBUTING.md "Contributing")
---
### Check Info
The plugin creates the service **_SERVICENAME_** for each discovered FOR WHAT with the **_HOW_TO_BUILD_THE_ITEM_** as item
<details><summary>Montoring states</summary>
| State | condition | WATO |
| ------ | ------ | ------ |
| WARN | condition 1 | yes |
| CRIT | condition 2 | no |
| WARN/CRIT | condition 3 | no |
</details>
<details><summary>Perfdata</summary>
| Metric | Unit | Perfometer |
| ------ | ------ | ------ |
| METRIC 1 | bit/s | yes |
| METRIC 2 | C | yes |
| METRIC 3 | V | no |
</details>
---
### WATO
<details><summary>Service monitoring rule</summary>
| Section | Rule name |
| ------ | ------ |
| Networking | NAME_OF_THE_RULE |
| Option | Defailt value |
| ------ | ------ |
| OPTION 1 | 10/50|
| OPTION 2 | 70/90 |
| OPTION 3 | CHOICE 1 |
| OPTION 4 | disabled |
</details>
<details><summary>Discovery rule</summary>
| Section | Rule name |
| ------ | ------ |
| Discovery of individual services | NAME_OF_THE_RULE |
| Option | Defailt value |
| ------ | ------ |
| OPTION 1 | disabled |
</details>
<details><summary>HW/SW inventory rules</summary>
The inventory plugin is not configurable.
</details>
---
### Sample Output
Sample output
Sample output details
