Netflow and OpenTSDB Integration

Input and output integration overview

The Netflow plugin is designed to collect traffic flow data from devices using the Netflow v5, v9 and IPFIX protocols. By capturing detailed flow information, this plugin supports network observability and analysis, enabling administrators to monitor traffic patterns and performance metrics effectively.

The OpenTSDB plugin facilitates the integration of Telegraf with OpenTSDB, allowing users to push time-series metrics to an OpenTSDB backend seamlessly.

Integration details

Netflow

The Netflow plugin serves as a collector for flow data using protocols such as Netflow v5, Netflow v9, and IPFIX. This plugin allows users to gather important flow metrics from devices that support these protocols, including a variety of operational insights about traffic patterns, source/destination information, and protocol usage. The plugin leverages templates sent by flow devices to decode incoming data correctly, and it supports private enterprise number mappings for vendor-specific information. With features like adjustable service addresses and buffer sizes, the plugin provides flexibility in how it can be deployed within various network architectures, making it an essential tool for network monitoring and analysis.

OpenTSDB

The OpenTSDB plugin is designed to send metrics to an OpenTSDB instance using either the telnet or HTTP mode. With the introduction of OpenTSDB 2.0, the recommended method for sending metrics is via the HTTP API, which allows for batch processing of metrics by configuring the ‘http_batch_size’. The plugin supports several configuration options including metrics prefixing, server host and port specification, URI path customization for reverse proxies, and debug options for diagnosing communication issues with OpenTSDB. This plugin is particularly useful in scenarios where time series data is generated and needs to be efficiently stored in a scalable time series database like OpenTSDB, making it suitable for a wide range of monitoring and analytics applications.

Configuration

Netflow

[[inputs.netflow]]
  ## Address to listen for netflow,ipfix or sflow packets.
  ##   example: service_address = "udp://:2055"
  ##            service_address = "udp4://:2055"
  ##            service_address = "udp6://:2055"
  service_address = "udp://:2055"

  ## Set the size of the operating system's receive buffer.
  ##   example: read_buffer_size = "64KiB"
  ## Uses the system's default if not set.
  # read_buffer_size = ""

  ## Protocol version to use for decoding.
  ## Available options are
  ##   "ipfix"      -- IPFIX / Netflow v10 protocol (also works for Netflow v9)
  ##   "netflow v5" -- Netflow v5 protocol
  ##   "netflow v9" -- Netflow v9 protocol (also works for IPFIX)
  ##   "sflow v5"   -- sFlow v5 protocol
  # protocol = "ipfix"

  ## Private Enterprise Numbers (PEN) mappings for decoding
  ## This option allows to specify vendor-specific mapping files to use during
  ## decoding.
  # private_enterprise_number_files = []

  ## Log incoming packets for tracing issues
  # log_level = "trace"

OpenTSDB

[[outputs.opentsdb]]
  ## prefix for metrics keys
  prefix = "my.specific.prefix."

  ## DNS name of the OpenTSDB server
  ## Using "opentsdb.example.com" or "tcp://opentsdb.example.com" will use the
  ## telnet API. "http://opentsdb.example.com" will use the Http API.
  host = "opentsdb.example.com"

  ## Port of the OpenTSDB server
  port = 4242

  ## Number of data points to send to OpenTSDB in Http requests.
  ## Not used with telnet API.
  http_batch_size = 50

  ## URI Path for Http requests to OpenTSDB.
  ## Used in cases where OpenTSDB is located behind a reverse proxy.
  http_path = "/api/put"

  ## Debug true - Prints OpenTSDB communication
  debug = false

  ## Separator separates measurement name from field
  separator = "_"

Input and output integration examples

Netflow

1. Traffic Analysis and Visualization: Use the Netflow plugin to collect traffic flow data and visualize it in real-time using an analytics platform. Administrators can create dashboards that display traffic patterns and anomalies, helping them understand bandwidth usage and user behavior.

2. Network Performance Optimization: Integrate the Netflow plugin with performance monitoring tools to identify bottlenecks and optimize the network. Analyze collected metrics to pinpoint areas where network resources can be improved, enhancing overall system performance.

3. Anomaly Detection for Security: Leverage the Netflow data for security analysis by feeding it into an anomaly detection system. This can help identify unusual traffic patterns that may indicate potential security threats, enabling quicker responses to prevent breaches.

4. Customized Alerts for Network Events: Configure threshold-based alerts using the Netflow plugin metrics to notify network administrators of unusual spikes or drops in traffic. This proactive monitoring can help in quickly addressing potential issues before they escalate.

OpenTSDB

1. Real-time Infrastructure Monitoring: Utilize the OpenTSDB plugin to collect and store metrics from various infrastructure components. By configuring the plugin to push metrics to OpenTSDB, organizations can have a centralized view of their infrastructure health and performance over time.

2. Custom Application Metrics Tracking: Integrate the OpenTSDB plugin into custom applications to track key performance indicators (KPIs) such as response times, error rates, and user interactions. This setup allows developers and product teams to visualize application performance trends and make data-driven decisions.

3. Automated Anomaly Detection: Leverage the plugin in conjunction with machine learning algorithms to automatically detect anomalies in time-series data sent to OpenTSDB. By continuously monitoring the incoming metrics, the system can train models that alert users to potential issues before they affect application performance.

4. Historical Data Analysis: Use the OpenTSDB plugin to store and analyze historical performance data for capacity planning and trend analysis. This provides valuable insights into system behavior over time, helping teams to understand usage patterns and prepare for future growth.

Feedback

Thank you for being part of our community! If you have any general feedback or found any bugs on these pages, we welcome and encourage your input. Please submit your feedback in the InfluxDB community Slack.