{"id":26292,"date":"2025-07-02T11:22:02","date_gmt":"2025-07-02T18:22:02","guid":{"rendered":"https:\/\/tdengine.com\/?p=26292"},"modified":"2025-07-28T15:18:02","modified_gmt":"2025-07-28T22:18:02","slug":"interconnecting-tsdbs-prometheus-and-tdengine","status":"publish","type":"post","link":"https:\/\/tdengine.com\/interconnecting-tsdbs-prometheus-and-tdengine\/","title":{"rendered":"Interconnecting TSDBs: Prometheus and TDengine"},"content":{"rendered":"\n

Prometheus<\/a> is an open-source monitoring and alerting toolkit widely adopted for its powerful time-series data model, flexible query language (PromQL), and efficient pull-based architecture. Prometheus excels at collecting metrics from a wide range of systems and applications, making it a go-to solution for IT infrastructure and application monitoring.<\/p>\n\n\n\n

TDengine is a high-performance time-series database purpose-built for industrial and real-time analytics scenarios. It features a compact storage engine, native stream processing, and SQL compatibility. With built-in connectors and low resource consumption, TDengine provides a lightweight yet powerful backend for managing massive volumes of time-stamped data efficiently.<\/p>\n\n\n\n

This article demonstrates how to interconnect these systems in two ways:<\/p>\n\n\n\n

    \n
  1. remote_write \/ remote_read from Prometheus \u2192 TDengine<\/li>\n\n\n\n
  2. TDengine\u2019s \/metrics<\/code> endpoint scraped by Prometheus<\/li>\n<\/ol>\n\n\n\n

    Prerequisites<\/h2>\n\n\n\n

    Make sure the following are in place:<\/p>\n\n\n\n

      \n
    • A running TDengine cluster<\/li>\n\n\n\n
    • taosAdapter installed and running<\/li>\n\n\n\n
    • Prometheus installed and running<\/li>\n<\/ul>\n\n\n\n

      Remote Read and Write Between Prometheus and TDengine<\/h2>\n\n\n\n
        \n
      1. \n

        Create the prometheus_data<\/code> database in TDengine:<\/p>\n\n\n\n

        CREATE DATABASE prometheus_data;<\/code><\/pre>\n<\/li>\n\n\n\n
      2. \n
        Add the following configuration items to prometheus.yml<\/code>:<\/p>\n\n\n\n
        remote_write:\n  - url: "http:\/\/<taosadapter-url>:6041\/prometheus\/v1\/remote_write\/prometheus_data"\n    basic_auth:\n      username: <tdengine-user>\n      password: <tdengine-password>\n\nremote_read:\n  - url: "http:\/\/<taosadapter-url>:6041\/prometheus\/v1\/remote_read\/prometheus_data"\n    basic_auth:\n      username: <tdengine-user>\n      password: <tdengine-password>\n    remote_timeout: 10s\n    read_recent: true<\/code><\/pre>\n\n\n\n
        Modify the URL, username, and password to match your TDengine deployment.<\/p>\n<\/li>\n\n\n\n
      3. \n
        Restart Prometheus:<\/p>\n\n\n\n
        sudo systemctl restart prometheus<\/code><\/pre>\n<\/li>\n\n\n\n
      4. \n
        In TDengine, view the metrics in the prometheus_data<\/code> database:<\/p>\n\n\n\n
        USE prometheus_data;\nSHOW STABLES;\nSELECT * FROM metrics LIMIT 10;<\/code><\/pre>\n<\/li>\n<\/ol>\n\n\n\n
        You should see frequent samples like go_gc_duration_seconds<\/code> confirming that remote_write<\/code> is working.<\/p>\n\n\n\n
        Monitoring TDengine with Prometheus<\/h2>\n\n\n\n
        taosKeeper exports TDengine metrics in Prometheus format at the \/metrics<\/code> endpoint so that you can monitor your TDengine cluster in Prometheus.<\/p>\n\n\n\n
          \n
        1. \n
          Ensure taosKeeper is running:<\/p>\n\n\n\n
          sudo systemctl status taoskeeper<\/code><\/pre>\n<\/li>\n\n\n\n
        2. \n
          Test the metrics endpoint:<\/p>\n\n\n\n
          curl http:\/\/<taoskeeper_host>:6041\/metrics<\/code><\/pre>\n\n\n\n
          You’ll see Prometheus\u2010style output, for example:<\/p>\n\n\n\n
          taos_connections 5\ntaos_query_latency_seconds{quantile="0.5"} 0.002<\/code><\/pre>\n<\/li>\n\n\n\n
        3. \n
          In prometheus.yml<\/code>, add a scrape config for taosKeeper:<\/p>\n\n\n\n
          scrape_configs:\n  - job_name: "tdengine"\n    static_configs:\n      - targets: ["<taoskeeper_host>:6041"]\n<\/code><\/pre>\n<\/li>\n\n\n\n
        4. \n
          Restart Prometheus:<\/p>\n\n\n\n
          sudo systemctl restart prometheus<\/code><\/pre>\n<\/li>\n<\/ol>\n\n\n\n
          You can now see TDengine metrics in Prometheus.<\/p>\n\n\n\n\"\"\n","protected":false},"excerpt":{"rendered":"
          This article demonstrates how to interconnect Prometheus and TDengine.<\/p>\n","protected":false},"author":127,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[21],"tags":[],"ppma_author":[261],"class_list":["post-26292","post","type-post","status-publish","format-standard","hentry","category-engineering"],"authors":[{"term_id":261,"user_id":127,"is_guest":0,"slug":"jfan","display_name":"Jim Fan","avatar_url":"https:\/\/eujqw4hwudm.exactdn.com\/wp-content\/uploads\/jfan-profile-new.jpg?strip=all&sharp=1&resize=96%2C96","1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/26292","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/users\/127"}],"replies":[{"embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/comments?post=26292"}],"version-history":[{"count":4,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/26292\/revisions"}],"predecessor-version":[{"id":26300,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/26292\/revisions\/26300"}],"wp:attachment":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/media?parent=26292"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/categories?post=26292"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/tags?post=26292"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/ppma_author?post=26292"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}