NSQ and Apache Inlong Integration

Input and output integration overview

The NSQ Telegraf plugin reads metrics from the NSQD messaging system, allowing for real-time data processing and monitoring.

The Inlong plugin connects Telegraf to Apache InLong, enabling seamless transmission of collected metrics to an InLong instance.

Integration details

NSQ

The NSQ plugin interfaces with NSQ, a real-time messaging platform, enabling the reading of messages from NSQD. This plugin is categorized as a service plugin, meaning it actively listens for metrics and events rather than polling them at regular intervals. With an emphasis on reliability, it prevents data loss by tracking undelivered messages until they are acknowledged by outputs. The plugin allows for configurations such as specifying NSQLookupd endpoints, topics, and channels, and it supports multiple data formats for flexibility in data handling.

Apache Inlong

This Inlong plugin is designed to publish metrics to an Apache InLong instance, which facilitates the management of data streams in a scalable manner. Apache InLong provides a robust framework for efficient data transmission between various components in a distributed environment. By leveraging this plugin, users can effectively route and transmit metrics collected by Telegraf to their InLong data-proxy infrastructure. As a key component in a data pipeline, the Inlong Output Plugin helps ensure that data is consistently formatted, streamed correctly, and managed in compliance with the standards set by Apache InLong, making it an essential tool for organizations looking to enhance their data analytics and reporting capabilities.

Configuration

NSQ

# Read metrics from NSQD topic(s)
[[inputs.nsq_consumer]]
  ## Server option still works but is deprecated, we just prepend it to the nsqd array.
  # server = "localhost:4150"

  ## An array representing the NSQD TCP HTTP Endpoints
  nsqd = ["localhost:4150"]

  ## An array representing the NSQLookupd HTTP Endpoints
  nsqlookupd = ["localhost:4161"]
  topic = "telegraf"
  channel = "consumer"
  max_in_flight = 100

  ## Max undelivered messages
  ## This plugin uses tracking metrics, which ensure messages are read to
  ## outputs before acknowledging them to the original broker to ensure data
  ## is not lost. This option sets the maximum messages to read from the
  ## broker that have not been written by an output.
  ##
  ## This value needs to be picked with awareness of the agent's
  ## metric_batch_size value as well. Setting max undelivered messages too high
  ## can result in a constant stream of data batches to the output. While
  ## setting it too low may never flush the broker's messages.
  # max_undelivered_messages = 1000

  ## Data format to consume.
  ## Each data format has its own unique set of configuration options, read
  ## more about them here:
  ## https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_INPUT.md
  data_format = "influx"

Apache Inlong

[[outputs.inlong]]
  ## Manager URL to obtain the Inlong data-proxy IP list for sending the data
  url = "http://127.0.0.1:8083"

  ## Unique identifier for the data-stream group
  group_id = "telegraf"  

  ## Unique identifier for the data stream within its group
  stream_id = "telegraf"  

  ## Data format to output.
  ## Each data format has its own unique set of configuration options, read
  ## more about them here:
  ## https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_OUTPUT.md
  # data_format = "influx"

Input and output integration examples

NSQ

1. Real-Time Analytics Dashboard: Integrate this plugin with a visualization tool to create a dashboard that displays real-time metrics from various topics in NSQ. By subscribing to specific topics, users can monitor system health and application performance dynamically, allowing for immediate insights and timely responses to any anomalies.

2. Event-Driven Automation: Combine NSQ with a serverless architecture to trigger automated workflows based on incoming messages. This use case could involve processing data for machine learning models or responding to user actions in applications, thus streamlining operations and enhancing user experience through rapid processing.

3. Multi-Service Communication Hub: Use the NSQ plugin to act as a centralized messaging hub among different microservices in a distributed architecture. By enabling services to communicate through NSQ, developers can ensure reliable message delivery while maintaining decoupled service interactions, significantly improving scalability and resilience.

4. Metrics Aggregation for Enhanced Monitoring: Implement the NSQ plugin to aggregate metrics from multiple sources before sending them to an analytics tool. This setup enables businesses to consolidate data from various applications and services, creating a unified view for better decision-making and strategic planning.

Apache Inlong

1. Real-time Metrics Monitoring: Integrating the Inlong plugin with a real-time monitoring dashboard allows teams to visualize system performance continuously. As metrics flow from Telegraf to InLong, organizations can create dynamic panels in their monitoring tools, providing instant insights into system health, resource utilization, and performance bottlenecks. This setup encourages proactive management and swift identification of potential issues before they escalate into critical failures.

2. Centralized Data Processing: Use the Inlong plugin to send Telegraf metrics to a centralized data processing pipeline that processes large volumes of data for analysis. By directing all collected metrics through Apache InLong, businesses can streamline their data workflows and ensure consistency in data formatting and processing. This centralized approach facilitates easier data integration with business intelligence tools and enhances decision-making through consolidated data insights.

3. Integration with Machine Learning Models: By feeding metrics collected through the Inlong Output Plugin into machine learning models, teams can enhance predictive analytics capabilities. For instance, metrics can be analyzed to predict system failures or performance trends. This application allows organizations to leverage historical data and infer future performance, helping them optimize resource allocation and minimize downtime using automated alerts based on model predictions.

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.