Free feature

Metrics

By enabling metrics and monitoring feature you will have access to a set of features that help you monitor your subscription. This bundle include features like custom notifications, insights and the metrics API.

How to enable

Metrics and monitoring is now available for all subscriptions with clustered architecture. This is how you can activate the new feature:

  • Login to the Sesam portal

  • Select the subscription you want to use

  • Navigate to Subscription on the left menu

  • Click on Products tab

  • Click on “Enable Metrics and monitoring”

Pricing

Follow the steps above to check how this feature affect your monthly price.

Metrics API

This feature will make the /api/metrics endpoint available. This API endpoint exposes Prometheus compatible metrics.

After enabling the feature, you will need to set up a prometheus database, then you can use tools, like Grafana, to create your own dashboards.

Note

You need a JWT token with Admin role to be able to scrape the endpoint.

Example:

curl -s -H "Authorization: bearer $JWT" "$SESAM_API_URL/metrics"

Note that all the counter metrics consists of two metrics suffixed by _counter and _created.

Service metrics

Metric

Type

Description

sesam_health

Enum<healthy|unhealthy|unknown>

Is the Sesam API up?

sesam_backup_health

Enum<healthy|unhealthy|unknown>

Are there any failed backups?

sesam_service_restarts

Gauge

Number of restarts since last upgrade

Pipe metrics

Metric

Type

Description

sesam_pipe_enabled

Gauge

Value is 1.0 if pipe is enabled and 0.0 if pipe is disabled.

sesam_pipe_config

Gauge

Value is 1.0 if pipe config is valid, 0.0 otherwise. Labels: config_group Configuration group name leaf 1 if pipe has no downstream pipes, 0 otherwise

sesam_pipe_usage

Gauge

Returns bytes used by pipe

sesam_pipe_queue_source

Gauge

Number of source entities in the pipe queue

sesam_pipe_queue_tracking

Gauge

Number of untracked entities in the pipe queue

sesam_pipe_queue_replicas

Gauge

Number of entities in the pipe’s replica queues

sesam_pipe_sink_dataset_count_index_exists

Gauge

Number of non-deleted entity ids in the sink dataset

sesam_pipe_sink_dataset_count_index_deleted

Gauge

Number of deleted entity ids in the sink dataset

sesam_pipe_sink_dataset_count_log_exists

Gauge

Number of non-deleted entities in the sink dataset log

sesam_pipe_sink_dataset_count_log_deleted

Gauge

Number of deleted entities in the sink dataset log

sesam_pipe_dead_letter_dataset_count_index_exists

Gauge

Number of non-deleted entity ids in the dead-letter dataset

sesam_pipe_dead_letter_dataset_count_index_deleted

Gauge

Number of deleted entity ids in the dead-letter dataset

sesam_pipe_dead_letter_dataset_count_log_exists

Gauge

Number of non-deleted entities in the dead-letter dataset log

sesam_pipe_dead_letter_dataset_count_log_deleted

Gauge

Number of deleted entities in the dead-letter dataset log

sesam_pipe_circuit_breaker_tripped

Gauge

Is the circuit-breaker tripped? 1.0 if tripped otherwise 0.0.

Pump metrics

Note that metrics are not exposed for pipes that are disabled or have pump.mode=”manual” or pump.mode=”off”.

Metric

Type

Description

sesam_pump_total_time

Gauge

Runtime in seconds. 0.0 if the pipe has not run yet.

sesam_pump_successful

Gauge

Was the last pump run successful? 1.0 if successful and -1.0 if not successful and 0.0 if the pipe has not run yet.

sesam_pump_started_total

Counter

The number of pump-started events. Note: no-op runs are not counted currently.

sesam_pump_completed_total

Counter

The number of pump-completed events. Note: no-op runs are not counted currently.

sesam_pump_failed_total

Counter

The number of non-interrupted pump-failed events.

sesam_pump_interrupted_total

Counter

The number of interrupted pump-failed events.

sesam_pump_entities_changes_total

Counter

The number of entities changed

sesam_pump_entities_seen_total

Counter

The number of entities seen

sesam_pump_entities_retryable

Gauge

The number of retryable entities in the retry queue.

sesam_pump_entities_compacted_total

Counter

The number of entities compacted away

sesam_pump_entities_deletion_tracked_total

Counter

The number of entities deletion tracked

sesam_pump_scrape_time

Gauge

The time when the metrics got scraped by the Prometheus client. The unit is the number of seconds since epoch.

sesam_pump_last_completed_time

Gauge

The time when the pump last completed or failed. The unit is the number of seconds since epoch.

sesam_pump_scheduled_time

Gauge

The time when the pump is next scheduled to run. The unit is the number of seconds since epoch.

sesam_pump_previous_scheduled_time

Gauge

The time when the pump was previously scheduled to run. In practice this is the run before the one scheduled at sesam_pump_scheduled_time. The unit is the number of seconds since epoch.