diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 693cbb1f8230e..d4eff23a42890 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -132,6 +132,7 @@ manifest.json @DataDog/documentation @DataDog/agent-integrations /tcp_queue_length/assets/logs/ @DataDog/container-integrations @DataDog/agent-integrations @DataDog/documentation @DataDog/logs-backend # NDM +/cisco_sdwan/ @DataDog/network-device-monitoring @DataDog/agent-integrations /snmp/ @DataDog/network-device-monitoring @DataDog/agent-integrations /snmp/*.md @DataDog/network-device-monitoring @DataDog/agent-integrations @DataDog/documentation /snmp_*/ @DataDog/network-device-monitoring @DataDog/agent-integrations diff --git a/.github/workflows/config/labeler.yml b/.github/workflows/config/labeler.yml index aba36a3bd37cb..4e0742a10dbcf 100644 --- a/.github/workflows/config/labeler.yml +++ b/.github/workflows/config/labeler.yml @@ -97,6 +97,8 @@ integration/cisco_aci: - cisco_aci/**/* integration/cisco_duo: - cisco_duo/**/* +integration/cisco_sdwan: +- cisco_sdwan/**/* integration/cisco_secure_firewall: - cisco_secure_firewall/**/* integration/cisco_umbrella_dns: diff --git a/cisco_sdwan/CHANGELOG.md b/cisco_sdwan/CHANGELOG.md new file mode 100644 index 0000000000000..31f5dcdc6f9b4 --- /dev/null +++ b/cisco_sdwan/CHANGELOG.md @@ -0,0 +1,4 @@ +# CHANGELOG - Cisco SD-WAN + + + diff --git a/cisco_sdwan/README.md b/cisco_sdwan/README.md new file mode 100644 index 0000000000000..ca114a611b0dd --- /dev/null +++ b/cisco_sdwan/README.md @@ -0,0 +1,43 @@ +# Agent Check: Cisco SD-WAN + +## Overview + +The Cisco SD-WAN integration lets you monitor your Cisco SD-WAN environment within [Network Device Monitoring][1]. Gain comprehensive insights into the performance and health of your SD-WAN infrastructure, including sites, tunnels, and devices. + +## Setup + +The Cisco SD-WAN NDM integration is currently in **Beta** and will not be billed until it is Generally Available. + +Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the [Autodiscovery Integration Templates][3] for guidance on applying these instructions. + +### Installation + +The Cisco SD-WAN check is included in the [Datadog Agent][2] package. +No additional installation is needed on your server. + +### Configuration + +The Cisco SD-WAN integrations needs valid credentials to access the Catalyst Manager instance. +Credentials should have the "Device monitoring" permission group. + +1. Edit the `cisco_sdwan.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your Cisco SD-WAN performance data. See the [sample cisco_sd_wan.d/conf.yaml][4] for all available configuration options. + +2. [Restart the Agent][5]. + +## Data Collected + +### Metrics + +See [metadata.csv][6] for a list of metrics provided by this integration. + +## Troubleshooting + +Need help? Contact [Datadog support][7]. + +[1]: https://app.datadoghq.com/devices +[2]: https://app.datadoghq.com/account/settings/agent/latest +[3]: https://docs.datadoghq.com/agent/kubernetes/integrations/ +[4]: https://github.com/DataDog/datadog-agent/blob/main/cmd/agent/dist/conf.d/cisco_sdwan.d/conf.yaml.example +[5]: https://docs.datadoghq.com/agent/guide/agent-commands/#start-stop-and-restart-the-agent +[6]: https://github.com/DataDog/integrations-core/blob/master/cisco_sd_wan/metadata.csv +[7]: https://docs.datadoghq.com/help/ diff --git a/cisco_sdwan/assets/dashboards/cisco_sd-wan.json b/cisco_sdwan/assets/dashboards/cisco_sd-wan.json new file mode 100644 index 0000000000000..2d12140c2eb0d --- /dev/null +++ b/cisco_sdwan/assets/dashboards/cisco_sd-wan.json @@ -0,0 +1,1855 @@ +{ + "author_name": "Datadog", + "description": "[[suggested_dashboards]]", + "layout_type": "ordered", + "template_variables": [ + { + "available_values": [], + "default": "*", + "name": "device_namespace", + "prefix": "device_namespace" + }, + { + "available_values": [], + "default": "*", + "name": "site_id", + "prefix": "site_id" + }, + { + "available_values": [], + "default": "*", + "name": "hostname", + "prefix": "hostname" + }, + { + "available_values": [], + "default": "*", + "name": "system_ip", + "prefix": "system_ip" + }, + { + "available_values": [], + "default": "*", + "name": "interface", + "prefix": "interface" + } + ], + "title": "Cisco SD-WAN", + "widgets": [ + { + "definition": { + "background_color": "blue", + "layout_type": "ordered", + "show_title": true, + "title": "Overview", + "type": "group", + "widgets": [ + { + "definition": { + "has_background": false, + "has_border": false, + "horizontal_align": "center", + "sizing": "cover", + "type": "image", + "url": "/static/images/logos/cisco_large.svg", + "vertical_align": "center" + }, + "id": 4619350414909276, + "layout": { + "height": 3, + "width": 6, + "x": 0, + "y": 0 + } + }, + { + "definition": { + "background_color": "white", + "content": "**Cisco SD-WAN Overview Dashboard**\n\nThis dashboard provides a comprehensive overview of your SD-WAN environment, allowing you to effortlessly monitor the status of your sites, tunnels, and devices. Stay informed about network performance, traffic patterns, and potential issues, to ensure optimal network efficiency and reliability.\n\n**Further reading on NDM**\n\n- Our blog post on [Monitoring Datacenters and network devices with Datadog](https://www.datadoghq.com/blog/datacenter-monitoring-dashboards/)\n- Network Device Monitoring [docs](https://docs.datadoghq.com/network_performance_monitoring/devices) ", + "font_size": "14", + "has_padding": true, + "show_tick": false, + "text_align": "left", + "tick_edge": "left", + "tick_pos": "50%", + "type": "note", + "vertical_align": "top" + }, + "id": 7609936259716352, + "layout": { + "height": 3, + "width": 6, + "x": 0, + "y": 3 + } + } + ] + }, + "id": 935293438892236, + "layout": { + "height": 7, + "width": 6, + "x": 0, + "y": 0 + } + }, + { + "definition": { + "background_color": "blue", + "layout_type": "ordered", + "show_title": true, + "title": "Sites Health", + "type": "group", + "widgets": [ + { + "definition": { + "has_search_bar": "auto", + "requests": [ + { + "formulas": [ + { + "alias": "Tunnels up", + "cell_display_mode": "number", + "conditional_formats": [ + { + "comparator": "<", + "palette": "black_on_light_yellow", + "value": 2 + }, + { + "comparator": ">", + "palette": "black_on_light_green", + "value": 2 + }, + { + "comparator": "<=", + "palette": "black_on_light_red", + "value": 1 + } + ], + "formula": "query1" + }, + { + "alias": "Avg latency", + "cell_display_mode": "number", + "formula": "query2", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "millisecond" + } + } + } + ], + "queries": [ + { + "aggregator": "max", + "data_source": "metrics", + "name": "query1", + "query": "sum:cisco_sdwan.tunnel.status{state:up,$device_namespace} by {site_id}" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query2", + "query": "max:cisco_sdwan.tunnel.latency{state:up,$device_namespace} by {site_id}" + } + ], + "response_format": "scalar", + "sort": { + "count": 500, + "order_by": [ + { + "index": 0, + "order": "asc", + "type": "formula" + } + ] + }, + "text_formats": [ + [], + [ + { + "match": { + "type": "is", + "value": "up" + }, + "palette": "black_on_light_green" + }, + { + "match": { + "type": "is_not", + "value": "" + }, + "palette": "black_on_light_red" + } + ] + ] + } + ], + "title": "Sites", + "title_align": "left", + "title_size": "16", + "type": "query_table" + }, + "id": 4978464917105286, + "layout": { + "height": 3, + "width": 3, + "x": 0, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "formulas": [ + { + "formula": "count_not_null(query1)" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "sum:cisco_sdwan.tunnel.status{$device_namespace} by {site_id,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "title": "SD-WAN Sites", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 3366793789694834, + "layout": { + "height": 3, + "width": 3, + "x": 3, + "y": 0 + } + }, + { + "definition": { + "color_preference": "text", + "count": 50, + "display_format": "countsAndList", + "hide_zero_counts": true, + "query": "cisco sd-wan", + "show_last_triggered": false, + "show_priority": false, + "sort": "status,asc", + "start": 0, + "summary_type": "monitors", + "title": "Monitors overview", + "type": "manage_status" + }, + "id": 1431607488305134, + "layout": { + "height": 3, + "width": 6, + "x": 0, + "y": 3 + } + } + ] + }, + "id": 4105254245177532, + "layout": { + "height": 7, + "width": 6, + "x": 6, + "y": 0 + } + }, + { + "definition": { + "background_color": "blue", + "layout_type": "ordered", + "show_title": true, + "title": "Controllers", + "type": "group", + "widgets": [ + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "green_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_nonzero(query1)" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vbond,$device_namespace,$system_ip} by {device_namespace,system_ip}" + } + ], + "response_format": "scalar" + } + ], + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Validators up", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 3671177390268672, + "layout": { + "height": 2, + "width": 2, + "x": 0, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "red_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_not_null(cutoff_max(query1, 0.5))" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vbond,$device_namespace,$system_ip} by {system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Validators down", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 2984469459443936, + "layout": { + "height": 2, + "width": 2, + "x": 2, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "green_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_not_null(query1)" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vsmart,$device_namespace,$system_ip} by {system_ip,device_hostname}" + } + ], + "response_format": "scalar" + } + ], + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Controllers up", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 4826237700518540, + "layout": { + "height": 2, + "width": 2, + "x": 4, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "red_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_not_null(cutoff_max(query1, 0.5))" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vsmart,$device_namespace,$system_ip} by {system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "time": {}, + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Controllers down", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 322242489397432, + "layout": { + "height": 2, + "width": 2, + "x": 6, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "green_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_not_null(query1)" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vmanage,$device_namespace,$system_ip} by {system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Managers up", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 4218621438666410, + "layout": { + "height": 2, + "width": 2, + "x": 8, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "red_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_not_null(cutoff_max(query1, 0.5))" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vmanage,$device_namespace,$system_ip} by {system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "time": {}, + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Managers down", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 1470058880191572, + "layout": { + "height": 2, + "width": 2, + "x": 10, + "y": 0 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "query1" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.cpu.usage{(type:vsmart OR type:vbond OR type:vmanage) AND $hostname AND $site_id AND $device_namespace AND $system_ip} by {hostname,system_ip,type}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "CPU %", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 8023478344148984, + "layout": { + "height": 2, + "width": 4, + "x": 0, + "y": 2 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "query1" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.memory.usage{(type:vsmart OR type:vbond OR type:vmanage) AND $hostname AND $site_id AND $device_namespace AND $system_ip} by {hostname,system_ip,type}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Memory %", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 4849815149829142, + "layout": { + "height": 2, + "width": 4, + "x": 4, + "y": 2 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "query1", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "percent" + } + } + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.disk.usage{(type:vsmart OR type:vbond OR type:vmanage) AND $hostname AND $site_id AND $device_namespace AND $system_ip} by {hostname,system_ip,type}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Disk %", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 8898738309346606, + "layout": { + "height": 2, + "width": 4, + "x": 8, + "y": 2 + } + }, + { + "definition": { + "has_search_bar": "auto", + "requests": [ + { + "formulas": [ + { + "alias": "Status", + "cell_display_mode": "number", + "conditional_formats": [ + { + "comparator": ">", + "palette": "black_on_light_green", + "value": 0 + } + ], + "formula": "query1" + } + ], + "queries": [ + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.omp_peer.status{$hostname,$site_id,$device_namespace,type:vsmart,$system_ip} by {site_id,hostname,system_ip,remote_site_id,remote_hostname,remote_type,legit,state}" + } + ], + "response_format": "scalar", + "sort": { + "count": 50, + "order_by": [ + { + "index": 0, + "order": "desc", + "type": "formula" + } + ] + } + } + ], + "title": "OMP Peers", + "title_align": "left", + "title_size": "16", + "type": "query_table" + }, + "id": 1469926092028614, + "layout": { + "height": 5, + "width": 12, + "x": 0, + "y": 4 + } + } + ] + }, + "id": 744285248415926, + "layout": { + "height": 10, + "width": 12, + "x": 0, + "y": 7 + } + }, + { + "definition": { + "background_color": "blue", + "layout_type": "ordered", + "show_title": true, + "title": "Tunnels", + "type": "group", + "widgets": [ + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "green_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "default_zero(count_nonzero(query1))" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.tunnel.status{$hostname,$site_id,$device_namespace,state:up,$system_ip} by {system_ip,local_color,remote_color,remote_system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "title": "Tunnels up", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 5110325776178276, + "layout": { + "height": 2, + "width": 2, + "x": 0, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "red_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "default_zero(count_nonzero(query1))" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.tunnel.status{$hostname,$site_id,$device_namespace,state:down,$system_ip} by {system_ip,local_color,remote_color,remote_system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "title": "Tunnels down", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 5580645444956250, + "layout": { + "height": 2, + "width": 2, + "x": 2, + "y": 0 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "top(query2, 50, 'mean', 'desc')", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "millisecond" + } + } + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query2", + "query": "avg:cisco_sdwan.tunnel.latency{$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id,local_color,remote_hostname,remote_system_ip,remote_site_id,remote_color}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Top latencies", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 895609292978588, + "layout": { + "height": 2, + "width": 4, + "x": 4, + "y": 0 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "top(query2, 50, 'mean', 'desc')", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "byte" + } + } + }, + { + "formula": "top(query1, 50, 'mean', 'desc')", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "byte" + } + } + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query2", + "query": "sum:cisco_sdwan.tunnel.tx_bits{$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id,local_color,remote_hostname,remote_system_ip,remote_site_id,remote_color}.as_count()" + }, + { + "data_source": "metrics", + "name": "query1", + "query": "sum:cisco_sdwan.tunnel.rx_bits{$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id,local_color,remote_hostname,remote_system_ip,remote_site_id,remote_color}.as_count()" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Top traffic", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 5496154914157032, + "layout": { + "height": 2, + "width": 4, + "x": 8, + "y": 0 + } + }, + { + "definition": { + "has_search_bar": "auto", + "requests": [ + { + "formulas": [ + { + "alias": "Latency", + "cell_display_mode": "number", + "conditional_formats": [ + { + "comparator": "<", + "palette": "black_on_light_green", + "value": 50 + }, + { + "comparator": "<", + "palette": "black_on_light_yellow", + "value": 100 + }, + { + "comparator": ">=", + "palette": "black_on_light_red", + "value": 100 + } + ], + "formula": "query1", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "millisecond" + } + } + }, + { + "alias": "Jitter", + "cell_display_mode": "number", + "conditional_formats": [ + { + "comparator": "<", + "palette": "black_on_light_green", + "value": 50 + }, + { + "comparator": "<", + "palette": "black_on_light_yellow", + "value": 100 + }, + { + "comparator": ">=", + "palette": "black_on_light_red", + "value": 100 + } + ], + "formula": "query2" + }, + { + "alias": "Loss", + "cell_display_mode": "number", + "conditional_formats": [ + { + "comparator": "<", + "palette": "black_on_light_green", + "value": 50 + }, + { + "comparator": "<", + "palette": "black_on_light_yellow", + "value": 100 + }, + { + "comparator": ">=", + "palette": "black_on_light_red", + "value": 100 + } + ], + "formula": "query3", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "percent" + } + } + }, + { + "alias": "QOE", + "cell_display_mode": "number", + "conditional_formats": [ + { + "comparator": "<", + "palette": "black_on_light_green", + "value": 50 + }, + { + "comparator": "<", + "palette": "black_on_light_yellow", + "value": 100 + }, + { + "comparator": ">=", + "palette": "black_on_light_red", + "value": 100 + } + ], + "formula": "query4" + }, + { + "alias": "Status", + "cell_display_mode": "number", + "conditional_formats": [ + { + "comparator": ">", + "palette": "black_on_light_green", + "value": 0 + }, + { + "comparator": "<=", + "palette": "white_on_red", + "value": 0 + } + ], + "formula": "query5" + } + ], + "queries": [ + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.tunnel.latency{$hostname,$site_id,$device_namespace,$system_ip} by {system_ip,hostname,site_id,local_color,remote_system_ip,remote_hostname,remote_site_id,remote_color}" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query2", + "query": "avg:cisco_sdwan.tunnel.jitter{$hostname,$site_id,$device_namespace,$system_ip} by {system_ip,hostname,site_id,local_color,remote_system_ip,remote_hostname,remote_site_id,remote_color}" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query3", + "query": "avg:cisco_sdwan.tunnel.loss{$hostname,$site_id,$device_namespace,$system_ip} by {system_ip,hostname,site_id,local_color,remote_system_ip,remote_hostname,remote_site_id,remote_color}" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query4", + "query": "avg:cisco_sdwan.tunnel.qoe{$hostname,$site_id,$device_namespace,$system_ip} by {system_ip,hostname,site_id,local_color,remote_system_ip,remote_hostname,remote_site_id,remote_color}" + }, + { + "aggregator": "last", + "data_source": "metrics", + "name": "query5", + "query": "min:cisco_sdwan.tunnel.status{$hostname,$site_id,$device_namespace,$system_ip} by {system_ip,hostname,site_id,local_color,remote_system_ip,remote_hostname,remote_site_id,remote_color}" + } + ], + "response_format": "scalar", + "sort": { + "count": 500, + "order_by": [ + { + "index": 0, + "order": "desc", + "type": "formula" + } + ] + } + } + ], + "title": "Tunnels", + "title_align": "left", + "title_size": "16", + "type": "query_table" + }, + "id": 2573797378604048, + "layout": { + "height": 6, + "width": 12, + "x": 0, + "y": 2 + } + } + ] + }, + "id": 6401842860303328, + "layout": { + "height": 9, + "width": 12, + "x": 0, + "y": 17 + } + }, + { + "definition": { + "background_color": "blue", + "layout_type": "ordered", + "show_title": true, + "title": "WAN Edges", + "type": "group", + "widgets": [ + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "green_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_nonzero(query1)" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vedge,$device_namespace,$site_id,$system_ip} by {system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Edges up", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 6469093578730180, + "layout": { + "height": 2, + "width": 2, + "x": 0, + "y": 0 + } + }, + { + "definition": { + "autoscale": true, + "precision": 2, + "requests": [ + { + "conditional_formats": [ + { + "comparator": ">", + "palette": "red_on_white", + "value": 0 + } + ], + "formulas": [ + { + "formula": "count_not_null(cutoff_max(query1, 0.5))" + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.device.reachable{type:vedge,$device_namespace,$site_id,$system_ip} by {system_ip,device_namespace}" + } + ], + "response_format": "scalar" + } + ], + "timeseries_background": { + "type": "bars", + "yaxis": {} + }, + "title": "Edges down", + "title_align": "left", + "title_size": "16", + "type": "query_value" + }, + "id": 2484984471821140, + "layout": { + "height": 2, + "width": 2, + "x": 2, + "y": 0 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "query1" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.cpu.usage{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "CPU %", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 825708022521290, + "layout": { + "height": 2, + "width": 4, + "x": 4, + "y": 0 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "query1" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.memory.usage{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Memory %", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 1449280365731508, + "layout": { + "height": 2, + "width": 4, + "x": 8, + "y": 0 + } + }, + { + "definition": { + "legend": { + "type": "automatic" + }, + "requests": [ + { + "formulas": [ + { + "formula": "query1", + "limit": { + "count": 500, + "order": "desc" + } + } + ], + "queries": [ + { + "aggregator": "last", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.control_connection.status{$hostname,$site_id,$device_namespace,$system_ip} by {hostname,peer_type,local_color,state}" + } + ], + "response_format": "scalar", + "style": { + "palette": "datadog16" + } + } + ], + "title": "Control connections", + "title_align": "left", + "title_size": "16", + "type": "sunburst" + }, + "id": 4190475366165090, + "layout": { + "height": 4, + "width": 4, + "x": 0, + "y": 2 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "bars", + "formulas": [ + { + "formula": "query1" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "sum:cisco_sdwan.reboot.count{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}.as_count()" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Reboots", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 7920516611328712, + "layout": { + "height": 2, + "width": 4, + "x": 4, + "y": 2 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "formula": "query1", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "percent" + } + } + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.disk.usage{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Disk %", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 3378898933476166, + "layout": { + "height": 2, + "width": 4, + "x": 8, + "y": 2 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "bars", + "formulas": [ + { + "formula": "query1" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "sum:cisco_sdwan.crash.count{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}.as_count()" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Crashs", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 4974141601181476, + "layout": { + "height": 2, + "width": 4, + "x": 4, + "y": 4 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "bars", + "formulas": [ + { + "formula": "10 * query2", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "millisecond" + } + } + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query2", + "query": "sum:cisco_sdwan.device.uptime{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Uptime", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 3307635170669220, + "layout": { + "height": 2, + "width": 4, + "x": 8, + "y": 4 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "alias": "Bits Out", + "formula": "query1" + }, + { + "alias": "Bits In", + "formula": "query2" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "sum:cisco_sdwan.interface.tx_bits{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}.as_count()" + }, + { + "data_source": "metrics", + "name": "query2", + "query": "sum:cisco_sdwan.interface.rx_bits{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}.as_count()" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Traffic", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 1304752409606322, + "layout": { + "height": 2, + "width": 6, + "x": 0, + "y": 6 + } + }, + { + "definition": { + "legend_columns": [ + "avg", + "min", + "max", + "value", + "sum" + ], + "legend_layout": "auto", + "requests": [ + { + "display_type": "line", + "formulas": [ + { + "alias": "Bps Out", + "formula": "query1" + }, + { + "alias": "Bps In", + "formula": "query2" + } + ], + "queries": [ + { + "data_source": "metrics", + "name": "query1", + "query": "sum:cisco_sdwan.interface.tx_bps{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}" + }, + { + "data_source": "metrics", + "name": "query2", + "query": "sum:cisco_sdwan.interface.rx_bps{type:vedge,$hostname,$site_id,$device_namespace,$system_ip} by {hostname,system_ip,site_id}" + } + ], + "response_format": "timeseries", + "style": { + "line_type": "solid", + "line_width": "normal", + "palette": "dog_classic" + } + } + ], + "show_legend": false, + "title": "Traffic (Bits per second)", + "title_align": "left", + "title_size": "16", + "type": "timeseries" + }, + "id": 7911665527963424, + "layout": { + "height": 2, + "width": 6, + "x": 6, + "y": 6 + } + }, + { + "definition": { + "has_search_bar": "auto", + "requests": [ + { + "formulas": [ + { + "alias": "In Bandwidth Usage", + "cell_display_mode": "bar", + "formula": "query1", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "percent" + } + } + }, + { + "alias": "Out Bandwidth Usage", + "cell_display_mode": "bar", + "formula": "query2", + "number_format": { + "unit": { + "type": "canonical_unit", + "unit_name": "percent" + } + } + }, + { + "alias": "In Errors", + "cell_display_mode": "number", + "formula": "query4" + }, + { + "alias": "Out Errors", + "cell_display_mode": "number", + "formula": "query5" + }, + { + "alias": "In Bits", + "formula": "query6" + }, + { + "alias": "Out Bits", + "formula": "query7" + }, + { + "alias": "Speed", + "formula": "query3 / 1000" + } + ], + "queries": [ + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query1", + "query": "avg:cisco_sdwan.interface.rx_bandwidth_usage{$hostname,$site_id,$device_namespace,$system_ip,$interface} by {site_id,hostname,interface,vpn_id}" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query2", + "query": "avg:cisco_sdwan.interface.tx_bandwidth_usage{$hostname,$site_id,$device_namespace,$system_ip,$interface} by {site_id,hostname,interface,vpn_id}" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query4", + "query": "sum:cisco_sdwan.interface.rx_errors{$hostname,$site_id,$device_namespace,$system_ip,$interface} by {site_id,hostname,interface,vpn_id}.as_count()" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query5", + "query": "sum:cisco_sdwan.interface.tx_errors{$hostname,$site_id,$device_namespace,$system_ip,$interface} by {site_id,hostname,interface,vpn_id}.as_count()" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query6", + "query": "sum:cisco_sdwan.interface.tx_bits{$hostname,$site_id,$device_namespace,$system_ip,$interface} by {site_id,hostname,interface,vpn_id}.as_count()" + }, + { + "aggregator": "avg", + "data_source": "metrics", + "name": "query7", + "query": "sum:cisco_sdwan.interface.rx_bits{$hostname,$site_id,$device_namespace,$system_ip,$interface} by {site_id,hostname,interface,vpn_id}.as_count()" + }, + { + "aggregator": "last", + "data_source": "metrics", + "name": "query3", + "query": "avg:cisco_sdwan.interface.speed{$hostname,$site_id,$device_namespace,$system_ip,$interface} by {site_id,hostname,interface,vpn_id}" + } + ], + "response_format": "scalar", + "sort": { + "count": 50, + "order_by": [ + { + "index": 0, + "order": "desc", + "type": "formula" + } + ] + } + } + ], + "title": "Interfaces", + "title_align": "left", + "title_size": "16", + "type": "query_table" + }, + "id": 2373696653508728, + "layout": { + "height": 5, + "width": 12, + "x": 0, + "y": 8 + } + } + ] + }, + "id": 5414270826871604, + "layout": { + "height": 14, + "is_column_break": true, + "width": 12, + "x": 0, + "y": 26 + } + } + ] +} \ No newline at end of file diff --git a/cisco_sdwan/assets/monitors/device_reboot.json b/cisco_sdwan/assets/monitors/device_reboot.json new file mode 100644 index 0000000000000..11fe86e0a333d --- /dev/null +++ b/cisco_sdwan/assets/monitors/device_reboot.json @@ -0,0 +1,26 @@ +{ + "version": 2, + "created_at": "2024-04-05", + "last_updated_at": "2024-04-05", + "title": "Cisco SD-WAN Device has rebooted several times", + "tags": [ + "integration:cisco-sdwan" + ], + "description": "Repeated reboots are an indication of potential issues like software-related glitches, low memory conditions, corrupt software images, hardware faults, or software bugs. By identifying these concerns, this monitor ensures network stability and optimized performance.", + "definition": { + "name": "[Cisco SD-WAN] Device {{hostname.name}} ({{system_ip.name}}) rebooted more than 3 times in the last 10 minutes", + "type": "query alert", + "query": "sum(last_10m):sum:cisco_sdwan.reboot.count{*} by {device_namespace,hostname,system_ip} > 3", + "message": "{{#is_alert}}\nSD-WAN Device {{hostname.name}} ({{system_ip.name}}) rebooted more than 3 times in the last 10 minutes.\n{{/is_alert}}\n\nTo know more about the status of your device, you can have more information from the [NDM page for the device {{device_namespace.name}}:{{system_ip.name}}](/infrastructure/devices/graph?inspectedDevice={{device_namespace.name}}%3A{{system_ip.name}}).", + "tags": [], + "options": { + "thresholds": { + "critical": 3 + }, + "notify_audit": false, + "include_tags": true, + "new_group_delay": 60, + "notify_no_data": false + } + } +} diff --git a/cisco_sdwan/assets/monitors/device_unreachable.json b/cisco_sdwan/assets/monitors/device_unreachable.json new file mode 100644 index 0000000000000..6dbad34b8b167 --- /dev/null +++ b/cisco_sdwan/assets/monitors/device_unreachable.json @@ -0,0 +1,26 @@ +{ + "version": 2, + "created_at": "2024-04-05", + "last_updated_at": "2024-04-05", + "title": "Cisco SD-WAN Device is unreachable", + "tags": [ + "integration:cisco-sdwan" + ], + "description": "This monitor checks the reachability of Cisco SD-WAN devices within a specified namespace. It triggers an alert if a device becomes unreachable, indicating potential network connectivity issues.", + "definition": { + "name": "[Cisco SD-WAN] Device unreachable alert on {{hostname.name}} in namespace {{device_namespace.name}}", + "type": "query alert", + "query": "avg(last_5m):max:cisco_sdwan.device.reachable{*} by {hostname,system_ip,device_namespace} < 0.8", + "message": "{{#is_alert}}\nA network device {{hostname.name}} with IP {{system_ip.name}} in namespace {{device_namespace.name}} is unreachable.\n{{/is_alert}}\n{{#is_alert_recovery}}\nA network device {{hostname.name}} with IP {{system_ip.name}} in namespace {{device_namespace.name}} is reachable again.\n{{/is_alert_recovery}}\n\nTo know more about the status of your device, you can have more information from the [NDM page for the device {{device_namespace.name}}:{{system_ip.name}}](/infrastructure/devices/graph?inspectedDevice={{device_namespace.name}}%3A{{system_ip.name}}).", + "tags": [], + "options": { + "thresholds": { + "critical": 0.8 + }, + "notify_audit": false, + "include_tags": true, + "new_group_delay": 60, + "notify_no_data": false + } + } +} diff --git a/cisco_sdwan/assets/monitors/tunnel_down.json b/cisco_sdwan/assets/monitors/tunnel_down.json new file mode 100644 index 0000000000000..632eeac94d337 --- /dev/null +++ b/cisco_sdwan/assets/monitors/tunnel_down.json @@ -0,0 +1,28 @@ +{ + "version": 2, + "created_at": "2024-04-05", + "last_updated_at": "2024-04-05", + "title": "Cisco SD-WAN Tunnel is down", + "tags": [ + "integration:cisco-sdwan" + ], + "description": "This monitor detects when a Cisco SD-WAN tunnel becomes unavailable between two devices. It tracks the status of tunnels within a specified namespace and triggers an alert if a tunnel goes down, indicating potential connectivity issues.", + "definition": { + "name": "[Cisco SD-WAN] Tunnel is down between {{local_color.name}} {{hostname.name}} ({{system_ip.name}}) to {{remote_color.name}} {{remote_hostname.name}} ({{remote_system_ip.name}})", + "type": "query alert", + "query": "min(last_15m):min:cisco_sdwan.tunnel.status{*} by {device_namespace,system_ip,hostname,local_color,remote_system_ip,remote_hostname,remote_color} < 1", + "message": "{{#is_alert}}\nSD-WAN Tunnel is down between device {{hostname.name}} ({{system_ip.name}}), color {{local_color.name}} to device {{remote_hostname.name}} ({{remote_system_ip.name}}), color {{remote_color.name}}.\n{{/is_alert}}\n\n{{#is_alert_recovery}}\nSD-WAN Tunnel is back up between device {{hostname.name}} ({{system_ip.name}}), color {{local_color.name}} to device {{remote_hostname.name}} ({{remote_system_ip.name}}), color {{remote_color.name}}.\n{{/is_alert_recovery}}\n\nTo know more about the status of your device, you can have more information from the [NDM page for the device {{device_namespace.name}}:{{system_ip.name}}](/infrastructure/devices/graph?inspectedDevice={{device_namespace.name}}%3A{{system_ip.name}}).", + "tags": [], + "options": { + "thresholds": { + "critical": 1 + }, + "notify_audit": false, + "include_tags": true, + "new_group_delay": 60, + "notify_no_data": false, + "avalanche_window": 10, + "evaluation_delay": 1200 + } + } +} diff --git a/cisco_sdwan/assets/service_checks.json b/cisco_sdwan/assets/service_checks.json new file mode 100644 index 0000000000000..fe51488c7066f --- /dev/null +++ b/cisco_sdwan/assets/service_checks.json @@ -0,0 +1 @@ +[] diff --git a/cisco_sdwan/manifest.json b/cisco_sdwan/manifest.json new file mode 100644 index 0000000000000..8d5ff7ea5f5d3 --- /dev/null +++ b/cisco_sdwan/manifest.json @@ -0,0 +1,54 @@ +{ + "manifest_version": "2.0.0", + "app_uuid": "2da35edb-5e33-4e5f-93c3-65e08478d566", + "app_id": "cisco-sdwan", + "display_on_public_website": false, + "tile": { + "overview": "README.md#Overview", + "configuration": "README.md#Setup", + "support": "README.md#Support", + "changelog": "CHANGELOG.md", + "description": "Monitor your Cisco SD-WAN environment with Datadog.", + "title": "Cisco SD-WAN", + "media": [], + "classifier_tags": [ + "Supported OS::Linux", + "Supported OS::Windows", + "Supported OS::macOS", + "Category::Network" + ] + }, + "assets": { + "integration": { + "auto_install": true, + "source_type_id": 12300976, + "source_type_name": "Cisco SDWAN", + "configuration": {}, + "events": { + "creates_events": false + }, + "metrics": { + "prefix": "cisco_sdwan.", + "check": "cisco_sdwan.device.reachable", + "metadata_path": "metadata.csv" + }, + "service_checks": { + "metadata_path": "assets/service_checks.json" + } + }, + "dashboards": { + "Cisco SD-WAN": "assets/dashboards/cisco_sd-wan.json" + }, + "monitors": { + "[Cisco SD-WAN] Device Unreachable Alert": "assets/monitors/device_unreachable.json", + "[Cisco SD-WAN] Tunnel Down Alert": "assets/monitors/tunnel_down.json", + "[Cisco SD-WAN] Device Reboot Alert": "assets/monitors/device_reboot.json" + } + }, + "author": { + "support_email": "help@datadoghq.com", + "name": "Datadog", + "homepage": "https://www.datadoghq.com", + "sales_email": "info@datadoghq.com" + } +} diff --git a/cisco_sdwan/metadata.csv b/cisco_sdwan/metadata.csv new file mode 100644 index 0000000000000..b11e2ebaf9717 --- /dev/null +++ b/cisco_sdwan/metadata.csv @@ -0,0 +1,32 @@ +metric_name,metric_type,interval,unit_name,per_unit_name,description,orientation,integration,short_name,curated_metric +cisco_sdwan.bfd_session.status,gauge,,,,"The status of the BFD session. The value is 1 if the session is up, 0 otherwise.",0,cisco_sdwan,, +cisco_sdwan.control_connection.status,gauge,,,,"The status of the control connection. The value is 1 if the connection is up, 0 otherwise.",0,cisco_sdwan,, +cisco_sdwan.cpu.usage,gauge,,percent,,Percentage of CPU currently being used.,0,cisco_sdwan,, +cisco_sdwan.crash.count,count,,,,The number of crashes.,0,cisco_sdwan,, +cisco_sdwan.device.reachable,gauge,,,,"The status of the device. The value is 1 if the device is reachable, 0 otherwise.",0,cisco_sdwan,, +cisco_sdwan.device.uptime,gauge,,,,The time (in hundredths of a second) since the network management portion of the system was last re-initialized.,0,cisco_sdwan,, +cisco_sdwan.disk.usage,gauge,,percent,,The percentage of disk currently being used.,0,cisco_sdwan,, +cisco_sdwan.interface.rx_bandwidth_usage,gauge,,percent,,The percent rate of used received bandwidth.,0,cisco_sdwan,, +cisco_sdwan.interface.rx_bits,count,,bit,,The total number of bits received on the interface.,0,cisco_sdwan,, +cisco_sdwan.interface.rx_bps,gauge,,bit,second,The inbound bandwidth rate in bits per second.,0,cisco_sdwan,, +cisco_sdwan.interface.rx_drops,count,,packet,,The number of inbound packets chosen to be discarded even though no errors had been detected to prevent them being deliverable to a higher-layer protocol.,0,cisco_sdwan,, +cisco_sdwan.interface.rx_errors,count,,packet,,The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.,0,cisco_sdwan,, +cisco_sdwan.interface.speed,gauge,,,,The interface current speed in bits per second.,0,cisco_sdwan,, +cisco_sdwan.interface.status,gauge,,,,"For each interface of each monitored Cisco SD-WAN device, this metric reports always 1 with the admin_status and oper_status as tags, as long as a 'combined' status that can be used for monitors.",0,cisco_sdwan,, +cisco_sdwan.interface.tx_bandwidth_usage,gauge,,percent,,The percent rate of used sent bandwidth.,0,cisco_sdwan,, +cisco_sdwan.interface.tx_bits,count,,bit,,The total number of bits transmitted out of the interface.,0,cisco_sdwan,, +cisco_sdwan.interface.tx_bps,gauge,,bit,second,The outbound bandwidth rate in bits per second.,0,cisco_sdwan,, +cisco_sdwan.interface.tx_drops,count,,packet,,The number of outbound packets chosen to be discarded even though no errors had been detected to prevent them being transmitted.,0,cisco_sdwan,, +cisco_sdwan.interface.tx_errors,count,,packet,,The number of outbound packets that could not be transmitted because of errors.,0,cisco_sdwan,, +cisco_sdwan.memory.usage,gauge,,percent,,The percentage of memory currently being used.,0,cisco_sdwan,, +cisco_sdwan.omp_peer.status,gauge,,,,"The status of the OMP Peer connection. The value is 1 if the session is up, 0 otherwise.",0,cisco_sdwan,, +cisco_sdwan.reboot.count,count,,,,The number of reboots.,0,cisco_sdwan,, +cisco_sdwan.tunnel.jitter,gauge,,millisecond,,The jitter of the tunnel.,0,cisco_sdwan,, +cisco_sdwan.tunnel.latency,gauge,,millisecond,,The latency in milliseconds of the tunnel.,0,cisco_sdwan,, +cisco_sdwan.tunnel.loss,gauge,,percent,,The packet loss of the tunnel.,0,cisco_sdwan,, +cisco_sdwan.tunnel.qoe,gauge,,,,The QOE score of the tunnel.,0,cisco_sdwan,, +cisco_sdwan.tunnel.rx_bits,count,,bit,,The total number of bits received through the tunnel.,0,cisco_sdwan,, +cisco_sdwan.tunnel.rx_packets,count,,packet,,The total number of packets received through the tunnel.,0,cisco_sdwan,, +cisco_sdwan.tunnel.status,gauge,,,,"The status of the tunnel. The value is 1 if the tunnel is up, 0 otherwise.",0,cisco_sdwan,, +cisco_sdwan.tunnel.tx_bits,count,,bit,,The total number of bits transmitted out through the tunnel.,0,cisco_sdwan,, +cisco_sdwan.tunnel.tx_packets,count,,packet,,The total number of packets transmitted out through the tunnel.,0,cisco_sdwan,,