TELEMETRY PIPELINE
History and rollback

History and rollback

Telemetry Pipeline saves a history of each pipeline's configuration settings and statuses over time.

View configuration history

To view the configuration history for a specific pipeline, use the following command:

calyptia get pipeline_config_history --pipeline PIPELINE_ID

Replace PIPELINE_ID with the pipeline ID of your pipeline.

This command returns a list of configuration IDs that correspond to different snapshots from that pipeline's configuration history. Its output will be similar to the following:

 ID                                    AGE
 7c636cb9-2734-4168-81e3-3a84208049ae  36 seconds
 1542066b-c2ff-4908-bd81-4d815f9ae22a  1 minute
 7a3d0d8d-2e7a-4443-b5be-11b86942499c  5 minutes
 237e3f6f-52e9-4dea-a7da-070a58bf4884  15 hours

Limit results

Use the --last flag to display only a subset of configuration snapshots. For example, to return a list of the last five snapshots, run:

calyptia get pipeline_config_history --pipeline my-pipeline --last 5

View specific changes

Use the -o yaml flag to view the specific changes over time to that pipeline's configuration file:

calyptia get pipeline_config_history --pipeline my-pipeline -o yaml

Roll back pipeline configuration history

⚠️

If you used the --skip-config-validation flag when you created or modified a pipeline, you must also include that flag when you run the rollout command for that pipeline.

To roll back a pipeline to a previous configuration, use the following command:

calyptia rollout pipeline PIPELINE_ID --to-config-id CONFIG_ID

Replace the following:

Roll back a specific number of steps

In addition to using the history ID of a previous configuration, you can also specify the number of steps you want to roll back through the configuration history of a pipeline. To do so, use the following command:

calyptia rollout pipeline PIPELINE_ID --steps-back COUNT

Replace the following:

  • PIPELINE_ID: The pipeline ID of your pipeline.
  • COUNT: The number of steps to roll back through the pipeline's configuration history. This must be an integer value.

View status history

To view the status history for a specific pipeline, use the following command:

calyptia get pipeline_status_history --pipeline PIPELINE_ID

Replace PIPELINE_ID with the pipeline ID of your pipeline.

This command returns a list of pipeline statuses and corresponding configuration IDs over time. Its output will be similar to the following:

 STATUS   CONFIG ID                             AGE
 STARTED  237e3f6f-52e9-4dea-a7da-070a58bf4884  15 hours
 NEW      237e3f6f-52e9-4dea-a7da-070a58bf4884  15 hours