products:promonitor:latest:userguide:configuration:plugins:truewatch
Table of Contents
TrueWatch Integration
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 |
|---|---|---|
| STANDARD | 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
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
products/promonitor/latest/userguide/configuration/plugins/truewatch.txt · Last modified: by 127.0.0.1

