====== TrueWatch Integration ======
Redpeaks collects data (including SAP sources like SAP HANA and ABAP) and sends it to **TrueWatch**

{{..:plugins:pasted:20251013-173601.png}}

===== Before You Start =====
  * TrueWatch **DataKit** is installed and reachable from Redpeaks
  * You have a **DataKit API Token** and the **DataKit URL** (http/https + port)
  * Firewall allows outbound traffic from Redpeaks to DataKit

==== Fields ====
^ Field ^ What it means ^ Example / Notes ^
| **Active** | Turn the integration on or off | Keep **ON** to send data |
| **Name** | Display name of this integration | Truewatch QA |
| **URL** | DataKit endpoint (TrueWatch) | https://truewatch.example.com:9529 |
| **API Token** | Token generated by DataKit for this integration | Paste exact value from DataKit |
| **Max queue size** | Max number of items buffered locally if TrueWatch is slow/unavailable | Default '100000' works for most sites |
| **Batch size** | Number of items sent per request - Larger batches = higher throughput. | Default '50000' - Reduce if network limits apply|
| **Metric Mode** | How metrics are labeled/mapped | STANDARD |
| **Send Alarms** | Send alarms (events) to TrueWatch | enabled |
| **Send Metrics** | Send metrics/telemetry to TrueWatch | enabled |
| **Send Metadata** | Send host/item metadata (inventory/tags) | enabled|

^ Mode ^ Rule ^ Result ^
| **DEFAULT** | Use the whole key as the **measurement**, the **field** is fixed to **value** | 'cpu.usage' → measurement = 'cpu.usage', field = 'value' |
| **CUSTOM** | Split the key, the part **after** the dot is the **field** \\ if there is **no dot**, we keep the whole key as measurement and set field to **value** | 'cpu.usage' → measurement = 'cpu', field = 'usage' |

===== Notes =====
  * Prefer **HTTPS** for the DataKit URL
  * Keep **time synchronized** (NTP) between Collector and TrueWatch
  * Tune **Max queue size** and **Batch size** if you expect very high volumes
  * This plugin **does not read** from TrueWatch, it only exports to it

===== Troubleshooting =====
  * **Auth failed** - Check the API Token in Collector matches the token created in DataKit
  * **Cannot connect** - Verify the URL/port, DNS/SSL, and firewall rules toward DataKit 
  * **No data visible** - Confirm **Send Alarms/Metrics/Metadata** toggles, and check DataKit/TrueWatch ingestion logs