From 6b92acca50e429b43ade1dc4fc8643b3c49f2cf9 Mon Sep 17 00:00:00 2001 From: t_max <1172915550@qq.com> Date: Wed, 5 Feb 2025 11:32:18 +0800 Subject: [PATCH] docs: update taosAdapter doc --- docs/en/14-reference/01-components/03-taosadapter.md | 3 +-- docs/en/assets/resources/_collectd.mdx | 8 ++++---- docs/en/assets/resources/_icinga2.mdx | 4 ++-- docs/en/assets/resources/_prometheus.mdx | 6 +++--- docs/en/assets/resources/_statsd.mdx | 4 ++-- docs/en/assets/resources/_tcollector.mdx | 4 ++-- 6 files changed, 14 insertions(+), 15 deletions(-) diff --git a/docs/en/14-reference/01-components/03-taosadapter.md b/docs/en/14-reference/01-components/03-taosadapter.md index 975d96a594..e17b6243e6 100644 --- a/docs/en/14-reference/01-components/03-taosadapter.md +++ b/docs/en/14-reference/01-components/03-taosadapter.md @@ -63,7 +63,7 @@ Supported InfluxDB parameters are as follows: - `ttl` the lifespan of automatically created subtables, determined by the TTL parameter of the first data entry in the subtable, which cannot be updated. For more information, please refer to the TTL parameter in the [table creation document](../../sql-manual/manage-tables/). Note: Currently, InfluxDB's token authentication method is not supported, only Basic authentication and query parameter verification are supported. -Example: curl --request POST `http://127.0.0.1:6041/influxdb/v1/write?db=test` --user "root:taosdata" --data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000" +Example: `curl --request POST http://127.0.0.1:6041/influxdb/v1/write?db=test --user "root:taosdata" --data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"` ### Compatible with OpenTSDB JSON and telnet format writing @@ -114,7 +114,6 @@ After the installation is complete, you can start the taosAdapter service using ## Configuration - taosAdapter supports configuration through command-line parameters, environment variables, and configuration files. The default configuration file is `/etc/taos/taosadapter.toml`. Command-line parameters take precedence over environment variables, which take precedence over configuration files. The command-line usage is arg=val, such as taosadapter -p=30000 --debug=true, detailed list as follows: diff --git a/docs/en/assets/resources/_collectd.mdx b/docs/en/assets/resources/_collectd.mdx index f0e31cc396..d06164d0e7 100644 --- a/docs/en/assets/resources/_collectd.mdx +++ b/docs/en/assets/resources/_collectd.mdx @@ -1,4 +1,4 @@ -### Configuring taosAdapter +#### Configuring taosAdapter Method to configure taosAdapter to receive collectd data: @@ -21,11 +21,11 @@ The default database name written by taosAdapter is `collectd`, but you can also - You can also use taosAdapter command line parameters or set environment variables to start, to enable taosAdapter to receive collectd data, for more details please refer to the taosAdapter reference manual. -### Configuring collectd +#### Configuring collectd collectd uses a plugin mechanism that can write the collected monitoring data to different data storage software in various forms. TDengine supports direct collection plugins and write_tsdb plugins. -#### Configuring to receive direct collection plugin data +1. **Configuring to receive direct collection plugin data** Modify the related configuration items in the collectd configuration file (default location /etc/collectd/collectd.conf). @@ -47,7 +47,7 @@ LoadPlugin network ``` -#### Configuring write_tsdb plugin data +2. **Configuring write_tsdb plugin data** Modify the related configuration items in the collectd configuration file (default location /etc/collectd/collectd.conf). diff --git a/docs/en/assets/resources/_icinga2.mdx b/docs/en/assets/resources/_icinga2.mdx index 04133c115c..a843ace184 100644 --- a/docs/en/assets/resources/_icinga2.mdx +++ b/docs/en/assets/resources/_icinga2.mdx @@ -1,4 +1,4 @@ -### Configuring taosAdapter +#### Configuring taosAdapter Method to configure taosAdapter to receive icinga2 data: @@ -21,7 +21,7 @@ The default database name written by taosAdapter is `icinga2`, but you can also - You can also use taosAdapter command line parameters or set environment variables to enable taosAdapter to receive icinga2 data, for more details please refer to the taosAdapter reference manual -### Configuring icinga2 +#### Configuring icinga2 - Enable icinga2's opentsdb-writer (reference link https://icinga.com/docs/icinga-2/latest/doc/14-features/#opentsdb-writer) - Modify the configuration file `/etc/icinga2/features-enabled/opentsdb.conf` filling in \ with the domain name or IP address of the server running taosAdapter, \ with the corresponding port supported by taosAdapter for receiving icinga2 data (default is 6048) diff --git a/docs/en/assets/resources/_prometheus.mdx b/docs/en/assets/resources/_prometheus.mdx index 241c7ac5fe..79b36e440e 100644 --- a/docs/en/assets/resources/_prometheus.mdx +++ b/docs/en/assets/resources/_prometheus.mdx @@ -1,18 +1,18 @@ Configuring Prometheus is done by editing the Prometheus configuration file `prometheus.yml` (default location `/etc/prometheus/prometheus.yml`). -### Configure Third-Party Database Address +#### Configure Third-Party Database Address Set the `remote_read url` and `remote_write url` to point to the domain name or IP address of the server running the taosAdapter service, the REST service port (taosAdapter defaults to 6041), and the name of the database you want to write to in TDengine, ensuring the URLs are formatted as follows: - remote_read url: `http://:/prometheus/v1/remote_read/` - remote_write url: `http://:/prometheus/v1/remote_write/` -### Configure Basic Authentication +#### Configure Basic Authentication - username: \ - password: \ -### Example configuration of remote_write and remote_read in the prometheus.yml file +#### Example configuration of remote_write and remote_read in the prometheus.yml file ```yaml remote_write: diff --git a/docs/en/assets/resources/_statsd.mdx b/docs/en/assets/resources/_statsd.mdx index 7f79b0cd50..9415efa488 100644 --- a/docs/en/assets/resources/_statsd.mdx +++ b/docs/en/assets/resources/_statsd.mdx @@ -1,4 +1,4 @@ -### Configure taosAdapter +#### Configure taosAdapter Method to configure taosAdapter to receive StatsD data: @@ -29,7 +29,7 @@ The default database name written by taosAdapter is `statsd`, but you can also m - You can also use taosAdapter command line arguments or set environment variables to enable the taosAdapter to receive StatsD data. For more details, please refer to the taosAdapter reference manual. -### Configure StatsD +#### Configure StatsD To use StatsD, download its [source code](https://github.com/statsd/statsd). Modify its configuration file according to the example file `exampleConfig.js` found in the root directory of the local source code download. Replace \ with the domain name or IP address of the server running taosAdapter, and \ with the port that taosAdapter uses to receive StatsD data (default is 6044). diff --git a/docs/en/assets/resources/_tcollector.mdx b/docs/en/assets/resources/_tcollector.mdx index 03dc6714f6..41d115462d 100644 --- a/docs/en/assets/resources/_tcollector.mdx +++ b/docs/en/assets/resources/_tcollector.mdx @@ -1,4 +1,4 @@ -### Configuring taosAdapter +#### Configuring taosAdapter To configure taosAdapter to receive data from TCollector: @@ -21,7 +21,7 @@ The default database name that taosAdapter writes to is `tcollector`, but you ca - You can also use taosAdapter command line arguments or set environment variables to enable the taosAdapter to receive tcollector data. For more details, please refer to the taosAdapter reference manual. -### Configuring TCollector +#### Configuring TCollector To use TCollector, download its [source code](https://github.com/OpenTSDB/tcollector). Its configuration options are in its source code. Note: There are significant differences between different versions of TCollector; this only refers to the latest code in the current master branch (git commit: 37ae920).