Software development lifecycle events are used to describe various stages throughout the lifecycle of a software component.
Such events can include, but are not limited to
Software development lifecycle events are mainly composed of the following namespaces
artifact.* namespace)cicd.* namespace)deployment.* namespace)vcs.* namespace)The SDLC task event "build finished" is generated when a build task is finished in the CI/CD system.
| Attribute | Type | Description | Examples |
|---|---|---|---|
artifact.id | string | experimental The identifier of the software artifact, typically the name of the artifact. | carts-service |
artifact.name | string | experimental The human-readable name of the software artifact. | Carts service |
artifact.version | string | experimental The version of the software artifact, typically in Semantic Versioning format. | 0.1.1 |
cicd.pipeline.id | string | experimental The CI/CD pipeline's identifier, which is unique within one CI/CD system. | 12345 |
cicd.pipeline.run.id | string | experimental An identifier for a pipeline run, which is unique within one CI/CD system. | 9876 |
duration | duration | experimental The duration of the build task in nanoseconds. | 42 |
end_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the build task was finished. | 1649822520123123165 |
event.category | string | experimental Describes the SDLC event's category, which must be set to task for SDLC task events. | task |
event.id | string | experimental Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | experimental Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1 Tags: permission | SDLC_EVENT |
event.provider | string | experimental Source of the event, for example, the name of the component or system that generated the event. Tags: permission | github.com |
event.status | string | experimental The value must be set to finished for SDLC build finished task events. | finished |
event.type | string | experimental The value must be set to build for any task event describing a build in the software development lifecycle.Tags: permission | build |
event.version | string | experimental The version of the SDLC build finished task event. | 0.1.0 |
start_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the build task was started. | 1649822520123123123 |
task.id | string | experimental The unique task identifier. | 123 |
task.name | string | experimental A human-readable name for a task. | CI build my-service |
task.outcome | string | experimental Outcome of a task run. | Success; Warning; Failure; Error; Skipped; Canceled; TimedOut; NotApplicable |
task.queued.duration | duration | experimental How long was the tasks queued before it was started, in nanoseconds. | 1234 |
timestamp | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created. | 1649822520123123123 |
Automatically and unconditionally set to value SDLC_EVENT.
The SDLC task event "build started" is generated when a build task is started in the CI/CD system.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cicd.pipeline.id | string | experimental The CI/CD pipeline's identifier, which is unique within one CI/CD system. | 12345 |
cicd.pipeline.run.id | string | experimental An identifier for a pipeline run, which is unique within one CI/CD system. | 9876 |
event.category | string | experimental Describes the SDLC event's category, which must be set to task for SDLC task events. | task |
event.id | string | experimental Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | experimental Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1 Tags: permission | SDLC_EVENT |
event.provider | string | experimental Source of the event, for example, the name of the component or system that generated the event. Tags: permission | github.com |
event.status | string | experimental The value must be set to started for SDLC build started task events. | started |
event.type | string | experimental The value must be set to build for any task event describing a build in the software development lifecycle.Tags: permission | build |
event.version | string | experimental The version of the SDLC build started task event. | 0.1.0 |
start_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the build task was started. | 1649822520123123123 |
task.id | string | experimental The unique task identifier. | 123 |
task.name | string | experimental A human-readable name for a task. | CI build my-service |
timestamp | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created. | 1649822520123123123 |
Automatically and unconditionally set to value SDLC_EVENT.
The SDLC task event "change finished" is generated when a change is closed in the version control system. A change task is the platform-agnostic term for a pull request in GitHub or a merge request in GitLab.
| Attribute | Type | Description | Examples |
|---|---|---|---|
duration | duration | experimental How long the change was open in the version control system, in nanoseconds. | 42 |
end_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the change was closed in the version control system. | 1649822520123123165 |
event.category | string | experimental Describes the SDLC event's category, which must be set to task for SDLC task events. | task |
event.id | string | experimental Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | experimental Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1 Tags: permission | SDLC_EVENT |
event.provider | string | experimental Source of the event, for example, the name of the component or system that generated the event. Tags: permission | github.com |
event.status | string | experimental The value must be set to finished for SDLC change finished task events. | finished |
event.type | string | experimental The value must be set to change for any task event describing a change in the software development lifecycle.Tags: permission | change |
event.version | string | experimental The version of the SDLC change finished task event. | 0.1.0 |
start_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the change was opened in the version control system. | 1649822520123123123 |
task.id | string | experimental The internal identifier of the change tasks. It is typically unique per repository and generated by the version control system itself. | 871023010 |
task.name | string | experimental A human-readable name for a task. | [Pull Request] docs: Update of Readme.md |
timestamp | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created. | 1649822520123123123 |
vcs.change.id | string | experimental The identifier of the change, for example, pull request ID or merge request ID. It is typically unique per repository and generated by the version control system itself. | 1234 |
vcs.change.state | string | experimental The state of the change, for example, the state of a pull request or merge request. | closed; merged |
vcs.change.title | string | experimental The human-readable title of the change, for example, pull request title or merge request title. 2 | docs: Update of Readme.md |
vcs.change.url.full | string | experimental The full URL to the change, for example, the full URL to the pull request or merge request. | https://github.com/dynatrace-oss/terraform-provider-dynatrace/pull/20 |
vcs.ref.base.name | string | experimental The name of the reference in the repository. This can be a branch name or a tag name. 3 | my-branch-name |
vcs.ref.base.revision | string | experimental The revision in the repository. For Git this is a synonym for a commit hash, whereas in SVN it is a revision number. 4 | d4322ab6cba38d21ad83c9de304a6a214ecf2cdc; main; 1337 |
vcs.ref.head.name | string | experimental The name of the reference in the repository. This can be a branch name or a tag name. 5 | my-branch-name |
vcs.ref.head.revision | string | experimental The revision in the repository. For Git, this is a synonym for a commit hash, whereas in SVN, it is a revision number. 6 | d4322ab6cba38d21ad83c9de304a6a214ecf2cdc; main; 1337 |
vcs.repository.name | string | experimental The human-readable name of the repository. It should not include any additional identifiers like GitLab group or GitHub organization. 7 | dynatrace-configuration-as-code |
vcs.repository.url.full | string | experimental The repository's full URL. 8 | https://github.com/dynatrace-oss/terraform-provider-dynatrace |
Automatically and unconditionally set to value SDLC_EVENT.
The value is similar to task.name.
The base name refers to the starting point of a change. For example, if a feature branch was created from main,
main is the base reference of type branch.
The base revision refers to the starting revision of a change. For example, if a branch was created from a certain commit, this commit is the base revision.
The head name refers to the current reference's name. For example,
if main is currently checked out, the head name is main.
The head revision refers to the currently referenced revision.
Be aware that the repository name might clash with forked repositories.
For Git VCS, this should not include the .git URL suffix.
The SDLC task event "change started" is generated when a change is openend in the version control system. A change task is the platform-agnostic term for a pull request in GitHub or a merge request in GitLab.
| Attribute | Type | Description | Examples |
|---|---|---|---|
event.category | string | experimental Describes the SDLC event's category, which must be set to task for SDLC task events. | task |
event.id | string | experimental Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | experimental Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1 Tags: permission | SDLC_EVENT |
event.provider | string | experimental Source of the event, for example, the name of the component or system that generated the event. Tags: permission | github.com |
event.status | string | experimental The value must be set to started for SDLC change started task events. | started |
event.type | string | experimental The value must be set to change for any task event describing a change in the software development lifecycle.Tags: permission | change |
event.version | string | experimental The version of the SDLC change started task event. | 0.1.0 |
start_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the change was opened in the version control system. | 1649822520123123123 |
task.id | string | experimental The internal identifier of the change tasks. It is typically unique per repository and generated by the version control system itself. | 871023010 |
task.name | string | experimental A human-readable name for a task. | [Pull Request] docs: Update of Readme.md |
timestamp | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created. | 1649822520123123123 |
vcs.change.id | string | experimental The identifier of the change, for example, pull request ID or merge request ID. It is typically unique per repository and generated by the version control system itself. | 1234 |
vcs.change.state | string | experimental The state of the change, for example, the state of a pull request or merge request. | wip; open; reopened |
vcs.change.title | string | experimental The human-readable title of the change, for example, pull request title or merge request title. 2 | docs: Update of Readme.md |
vcs.change.url.full | string | experimental The full URL to the change, for example, the full URL to the pull request or merge request. | https://github.com/dynatrace-oss/terraform-provider-dynatrace/pull/20 |
vcs.ref.base.name | string | experimental The name of the reference in the repository. This can be a branch name or a tag name. 3 | my-branch-name |
vcs.ref.base.revision | string | experimental The revision in the repository. For Git this is a synonym for a commit hash, whereas in SVN it is a revision number. 4 | d4322ab6cba38d21ad83c9de304a6a214ecf2cdc; main; 1337 |
vcs.ref.head.name | string | experimental The name of the reference in the repository. This can be a branch name or a tag name. 5 | my-branch-name |
vcs.ref.head.revision | string | experimental The revision in the repository. For Git, this is a synonym for a commit hash, whereas in SVN, it is a revision number. 6 | d4322ab6cba38d21ad83c9de304a6a214ecf2cdc; main; 1337 |
vcs.repository.name | string | experimental The human-readable name of the repository. It should not include any additional identifiers like GitLab group or GitHub organization. 7 | dynatrace-configuration-as-code |
vcs.repository.url.full | string | experimental The repository's full URL. 8 | https://github.com/dynatrace-oss/terraform-provider-dynatrace |
Automatically and unconditionally set to value SDLC_EVENT.
The value is similar to task.name.
The base name refers to the starting point of a change. For example, if a feature branch was created from main,
main is the base reference of type branch.
The base revision refers to the starting revision of a change. For example, if a branch was created from a certain commit, this commit is the base revision.
The head name refers to the current reference's name. For example,
if main is currently checked out, the head name is main.
The head revision refers to the currently referenced revision.
Be aware that the repository name might clash with forked repositories.
For Git VCS, this should not include the .git URL suffix.
The SDLC pipeline event "run finished" is generated when a pipeline run is finished in the CI/CD system.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cicd.pipeline.id | string | experimental The CI/CD pipeline's identifier, which is unique within one CI/CD system. | 12345 |
cicd.pipeline.name | string | experimental The human-readable name of the CI/CD pipeline. | CI pipeline for main branch |
cicd.pipeline.run.id | string | experimental An identifier for a pipeline run, which is unique within one CI/CD system. | 9876 |
cicd.pipeline.run.outcome | string | experimental The outcome of one pipeline run. | success |
cicd.pipeline.run.queued.duration | duration | experimental How long was the pipeline run queued before it was started, in nanoseconds. | 1234 |
cicd.pipeline.run.url.full | string | experimental The URL pointing to one specific pipeline run. | https://github.com/ACME/ACME-repo/actions/runs/9876 |
cicd.pipeline.url.full | string | experimental The CI/CD pipeline's full URL. | https://github.com/ACME/ACME-repo/actions/workflows/ci-build.yml |
cicd.upstream_pipeline.id | string | experimental The identifier of the upstream CI/CD pipeline. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline. | 12345 |
cicd.upstream_pipeline.run.id | string | experimental The identifier of the upstream CI/CD pipeline run. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline run. | 1337 |
duration | duration | experimental The duration of the pipeline run in nanoseconds. | 1234 |
end_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the pipeline run was finished. | 1649822520123123165 |
event.category | string | experimental Describes the SDLC event's category, which must be set to pipeline for all pipeline events. | pipeline |
event.id | string | experimental Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | experimental Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1 Tags: permission | SDLC_EVENT |
event.provider | string | experimental Source of the event, for example, the name of the component or system that generated the event. Tags: permission | github.com |
event.status | string | experimental The value must be set to finished for SDLC pipeline run finished events. | finished |
event.type | string | experimental The value must be set to run for SDLC pipeline run finished events.Tags: permission | run |
event.version | string | experimental The version of the SDLC pipeline run finished event. | 0.1.0 |
start_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the pipeline run was started. | 1649822520123123123 |
timestamp | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created. | 1649822520123123123 |
Automatically and unconditionally set to value SDLC_EVENT.
The SDLC pipeline event "run queued" is generated when a pipeline run is queued in the CI/CD system.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cicd.pipeline.id | string | experimental The CI/CD pipeline's identifier, which is unique within one CI/CD system. | 12345 |
cicd.pipeline.name | string | experimental The human-readable name of the CI/CD pipeline. | CI pipeline for main branch |
cicd.pipeline.run.id | string | experimental An identifier for a pipeline run, which is unique within one CI/CD system. | 9876 |
cicd.pipeline.run.url.full | string | experimental The URL pointing to one specific pipeline run. | https://github.com/ACME/ACME-repo/actions/runs/9876 |
cicd.pipeline.url.full | string | experimental The CI/CD pipeline's full URL. | https://github.com/ACME/ACME-repo/actions/workflows/ci-build.yml |
cicd.upstream_pipeline.id | string | experimental The identifier of the upstream CI/CD pipeline. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline. | 12345 |
cicd.upstream_pipeline.run.id | string | experimental The identifier of the upstream CI/CD pipeline run. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline run. | 1337 |
event.category | string | experimental Describes the SDLC event's category, which must be set to pipeline for all pipeline events. | pipeline |
event.id | string | experimental Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | experimental Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1 Tags: permission | SDLC_EVENT |
event.provider | string | experimental Source of the event, for example, the name of the component or system that generated the event. Tags: permission | github.com |
event.status | string | experimental The value must be set to queued for SDLC pipeline run queued events. | queued |
event.type | string | experimental The value must be set to run for SDLC pipeline run queued events.Tags: permission | run |
event.version | string | experimental The version of the SDLC pipeline run queued event. | 0.1.0 |
start_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the pipeline run was queued. | 1649822520123123123 |
timestamp | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created. | 1649822520123123123 |
Automatically and unconditionally set to value SDLC_EVENT.
The SDLC pipeline event "run started" is generated when a pipeline run is started in the CI/CD system.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cicd.pipeline.id | string | experimental The CI/CD pipeline's identifier, which is unique within one CI/CD system. | 12345 |
cicd.pipeline.name | string | experimental The human-readable name of the CI/CD pipeline. | CI pipeline for main branch |
cicd.pipeline.run.id | string | experimental An identifier for a pipeline run, which is unique within one CI/CD system. | 9876 |
cicd.pipeline.run.queued.duration | duration | experimental How long was the pipeline run queued before it was started, in nanoseconds. | 1234 |
cicd.pipeline.run.url.full | string | experimental The URL pointing to one specific pipeline run. | https://github.com/ACME/ACME-repo/actions/runs/9876 |
cicd.pipeline.url.full | string | experimental The CI/CD pipeline's full URL. | https://github.com/ACME/ACME-repo/actions/workflows/ci-build.yml |
cicd.upstream_pipeline.id | string | experimental The identifier of the upstream CI/CD pipeline. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline. | 12345 |
cicd.upstream_pipeline.run.id | string | experimental The identifier of the upstream CI/CD pipeline run. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline run. | 1337 |
event.category | string | experimental Describes the SDLC event's category, which must be set to pipeline for all pipeline events. | pipeline |
event.id | string | experimental Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | experimental Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1 Tags: permission | SDLC_EVENT |
event.provider | string | experimental Source of the event, for example, the name of the component or system that generated the event. Tags: permission | github.com |
event.status | string | experimental The value must be set to started for SDLC pipeline run started events. | started |
event.type | string | experimental The value must be set to run for SDLC pipeline run started events.Tags: permission | run |
event.version | string | experimental The version of the SDLC pipeline run started event. | 0.1.0 |
start_time | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the pipeline run was started. | 1649822520123123123 |
timestamp | timestamp | experimental The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created. | 1649822520123123123 |
Automatically and unconditionally set to value SDLC_EVENT.