⚠️ Troubleshooting CI/CD events

Validating your events

The easiest way to confirm your data was added correctly to Faros is to inspect it with GraphQL.

Validating CI Events

CI events create artifacts in Faros. Run the query below to inspect your artifacts data in Faros. Check that :

  • There is at least one commit associated to the artifact that exists in the Faros system: the commit sha has a non-null sha
  • The repository exists in the Faros system: the repository name should be non-null
  • The timespan between createdAt and startedAt makes sense with regard to experienced build time of your engineers
{
  cicd {
    artifacts {
      nodes {
        uid
        commitAssociations {
          nodes {
            commit {
              id
              sha
              message
              metadata {
                isPhantom
              }
              repository {
                name
                organization {
                  name
                }
              }
            }
          }
        }
        build {
          endedAt
          startedAt
        }
      }
    }
  }
}

Validating CD Events

CD events create deployment objects. Run the query below to inspect your deployment data in Faros. Check that:

  • There are deployments in the system
  • Fields you expect to have values are not null
  • Deployment references an artifact that exists in the system: the artifact uid is non-null
  • The commit exists in the system: the commit sha is non-null
  • isPhantom is false for all
{
  cicd {
    deployments {
      nodes {
        metadata {
          origin
        }
        uid
        env {
          category
        }
        application {
          name
        }
        artifacts {
          nodes {
            artifact {
              uid
              metadata {
                isPhantom
              }
              commitAssociations {
                nodes {
                  commit {
                    metadata {
                      isPhantom
                    }
                    sha
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Validating CD and Artifacts Connection

If you are sending both CI and CD events, you will want to verify that the artifacts you create are correctly tied to their deployments. Check the following:

  • Deployment fields are non-null for the values you expect
  • The commit exists in the system: the commit sha is non-null
  • isPhantom is false for all
{
  cicd {
    artifacts {
      nodes {
        uid
        deployments {
          nodes {
            deployment {
              startedAt
              endedAt
              status {
                category
              }
              env {
                category
                detail
              }
              application {
                name
              }
            }
          }
        }
        commitAssociations {
          nodes {
            commit {
              id
              sha
              message
              metadata {
                isPhantom
              }
              repository {
                name
                organization {
                  name
                }
              }
            }
          }
        }
      }
    }
  }
}

Visualizations

Once the CI and CD events appear in GraphQL, sync the graph so the events can be visualized in your favorite Faros dashboards and charts. If you have any questions, reach out to [email protected] for help!


Did this page help you?