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:
PIPELINE_ID
: The pipeline ID of your pipeline.CONFIG_ID
: The configuration ID you want to roll your pipeline back to.
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