mirror of
https://github.com/ClusterCockpit/cc-metric-collector.git
synced 2024-12-26 15:29:04 +01:00
8e8be09ed9
* Add cpu_used (all-cpu_idle) to CpustatCollector * Update cc-metric-collector.init * Allow selection of timestamp precision in HttpSink * Add comment about precision requirement for cc-metric-store * Fix for API changes in gofish@v0.15.0 * Update requirements to latest version * Read sensors through redfish * Update golang toolchain to 1.21 * Remove stray error check * Update main config in configuration.md * Update Release action to use golang 1.22 stable release, no golang RPMs anymore * Update runonce action to use golang 1.22 stable release, no golang RPMs anymore * Update README.md Use right JSON type in configuration * Update sink's README * Test whether ipmitool or ipmi-sensors can be executed without errors --------- Co-authored-by: Holger Obermaier <Holger.Obermaier@kit.edu> Co-authored-by: Holger Obermaier <40787752+ho-ob@users.noreply.github.com>
42 lines
1.8 KiB
Markdown
42 lines
1.8 KiB
Markdown
## `http` sink
|
|
|
|
The `http` sink uses POST requests to a HTTP server to submit the metrics in the InfluxDB line-protocol format. It uses JSON web tokens for authentification. The sink creates batches of metrics before sending, to reduce the HTTP traffic.
|
|
|
|
### Configuration structure
|
|
|
|
```json
|
|
{
|
|
"<name>": {
|
|
"type": "http",
|
|
"meta_as_tags" : [
|
|
"meta-key"
|
|
],
|
|
"url" : "https://my-monitoring.example.com:1234/api/write",
|
|
"jwt" : "blabla.blabla.blabla",
|
|
"username": "myUser",
|
|
"password": "myPW",
|
|
"timeout": "5s",
|
|
"idle_connection_timeout" : "5s",
|
|
"flush_delay": "2s",
|
|
"batch_size": 1000,
|
|
"precision": "s"
|
|
}
|
|
}
|
|
```
|
|
|
|
- `type`: makes the sink an `http` sink
|
|
- `meta_as_tags`: Move specific meta information to the tags in the output (optional)
|
|
- `url`: The full URL of the endpoint
|
|
- `jwt`: JSON web tokens for authentication (Using the *Bearer* scheme)
|
|
- `username`: username for basic authentication
|
|
- `password`: password for basic authentication
|
|
- `timeout`: General timeout for the HTTP client (default '5s')
|
|
- `max_retries`: Maximum number of retries to connect to the http server
|
|
- `idle_connection_timeout`: Timeout for idle connections (default '120s'). Should be larger than the measurement interval to keep the connection open
|
|
- `flush_delay`: Batch all writes arriving in during this duration (default '1s', batching can be disabled by setting it to 0)
|
|
- `batch_size`: Maximal batch size. If `batch_size` is reached before the end of `flush_delay`, the metrics are sent without further delay
|
|
- `precision`: Precision of the timestamp. Valid values are 's', 'ms', 'us' and 'ns'. (default is 'ns')
|
|
|
|
### Using HttpSink for communication with cc-metric-store
|
|
|
|
The cc-metric-store only accepts metrics with a timestamp precision in seconds, so it is required to set `"precision": "s"`. |