GuidesAPI Reference
Log In

Querying Deployments

To query for deployments tracked by Clairvoyance, use pvnctl deployments log.

pvnctl deployments log

The output of the command will be a list of deployments tracked by Clairvoyance. For example:

deployment dpl-cbd4ac1f45bd42c681df3f7b6232ec35
Created Date:      2023-11-02T21:45:18Z
Last Updated Date: 2023-11-02T21:45:19Z
Status:            SUCCEEDED

  Deployment System: github-actions
  Application:       clairvoyance-demo
  Service:           demo
  Release Channel:   staging
  Commit Range:      a1fa304..f262603 (17 commits)
  High Impact Commits:
    f262603 ([email protected]): BACKEND  Merge commits can potentially introduce errors or conflicts. Merging a hotfix indicates a significant issue was addressed.
    9aa93da ([email protected]): FRONTEND The change seems targeted at improving performance. The change is focussed on optimization and not feature addition or removal.
    02fef87 ([email protected]): BACKEND  Commit message indicates a hotfix related to performance which could potentially result in an outage. The likelihood of an outa
ge is medium as it is directly related to performance.
    f73ab00 ([email protected]): BACKEND  Adding a new feature such as push notifications is a high risk as it can lead to unexpected user issues. Given the new feature 
addition the possibility of a user issue arising is moderate.
    c36b8a6 ([email protected]): FRONTEND Enhanced error messages improve user experience. Changes to error messages can sometimes lead to user issues if not done properly but the commit seems to be addressing a known problem.

Clairvoyance will give you relevant information about the deployment, such as the commit range, and automatically figure out what commits are likely to be high impact.

All deployments have ids beginning with dpl-. pvnctl deployments log follows a similar semantic to git log.

pvnctl deployments log --app=my-app --service=my-service # filter to a specific app and service
pvnctl deployments log --app=my-app --release-channel=staging --release-channel=prod # filter to my-app on release channels staging and prod
pvnctl deployments log dpl-123..dpl-456  # get all deployments between dpl-123 and dpl-456