Metrics
Category: Monitoring
Node id: metrics
Collects, aggregates, and queries metrics including counters, gauges, histograms, summaries, and timers
What it does
- Counter metrics with increment/decrement operations
- Gauge metrics for point-in-time values
- Histogram metrics with percentile calculations (p50, p75, p90, p95, p99, p999)
- Summary metrics with min, max, mean, and sum aggregation
- Timer metrics for duration tracking with percentile breakdowns
- Query metrics by name and type filters
- Reset individual or all metrics
- Label/tag support for metric dimensionality
Use cases
- Track pipeline execution counts and success rates
- Monitor API response times with histogram percentiles
- Record patient processing throughput as gauge metrics
- Generate summary reports of all collected metrics
- Instrument healthcare data pipeline performance
Runtime
- Performance tier:
fast
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
value | any | No | Metric value to record |
duration | any | No | Duration in milliseconds (timer operation) |
labels | json | No | Labels/tags for the metric |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | Metrics result with metrics map, summary, count, operation, processed_at, and duration_ms |
success | boolean | No | Whether the metrics operation succeeded |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Operation | operation | enum | No | record | record, increment, decrement, gauge, timer, histogram, summary, query, reset | Metrics operation to perform |
| Metric Name | metric_name | string | No | Name of the metric | ||
| Metric Type | metric_type | enum | No | counter | counter, gauge, histogram, summary, timer | Type of metric |
| Value | value | number | No | 0 | Static metric value |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Delta | delta | number | No | 1 | Increment/decrement delta | |
| Duration | duration | number | No | 0 | Timer duration in milliseconds | |
| Labels | labels | json | No | Metric labels/tags | ||
| Name Filter | name_filter | string | No | Filter metrics by name (query operation) | ||
| Type Filter | type_filter | string | No | Filter metrics by type (query operation) |
Errors
| Code | Description |
|---|---|
MISSING_METRIC_NAME | metric_name is required for record/increment/decrement/gauge/timer/histogram operations |
UNSUPPORTED_OPERATION | Operation is not one of the supported metrics operations |
Runtime notes
- Metrics are held in memory per node instance; they reset when the pipeline restarts
- Histogram/summary operations auto-compute p50-p999 percentiles in the result
- The 'summary' operation returns all registered metrics in one map keyed by metric name
- Output always includes both 'result' (map) and 'success' (bool) top-level keys
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.