Skip to main content

Install taosX-Agent

ENTERPRISE FEATURE

The features or components discussed in this document are available in TDengine TSDB-Enterprise only. TDengine TSDB-OSS does not include these features or components.

If TDengine TSDB cannot connect directly to your data source, you can install taosX-Agent on the network where your data source is located. You can install taosX-Agent on the machine where your data source is located or on a different machine on the same network that can access the data source. TDengine TSDB can then connect to your data source through taosX-Agent.

note
  • It is not necessary to install TDengine TSDB on the same machine as the data source.
  • If TDengine TSDB can connect directly to your data source, it is not necessary to install taosX-Agent.

Create Agent​

  1. In a web browser, access TDengine TSDB.

  2. From the main menu on the left, select Data In.

  3. Open the Agent tab and click Create New Agent.

  4. Click Windows to download taosX-Agent.

  5. On your local machine, run the taosX-Agent installer and follow the prompts.

  6. In TDengine TSDB, click Next.

  7. Enter a unique name for your agent and click Next to generate an authentication token.

  8. On your local machine, open the C:\TDengine\cfg\agent.toml file.

  9. Copy the values of endpoint and token displayed in TDengine TSDB into the agent.toml file.

    endpoint="http://localhost:6055"
    token="eyJ0eX...BhA"

  10. In TDengine TSDB, click Next.

  11. On your local machine, open a terminal as an administrator and run the following command:

    sc start taosx-agent

  12. In TDengine TSDB, click Check Agent Connection.

  13. If Success is displayed, click Finish.

When you create data in tasks, you can use this agent to connect to your data source.

For full configuration options, see taosX-Agent.