-
Notifications
You must be signed in to change notification settings - Fork 1.3k
[SDCI-2062] Update Azure pipelines docs to show GA of log collection #34122
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Conversation
Preview links (active after the
|
Signed-off-by: Borja Gomez <borja.gomez@datadoghq.com>
Signed-off-by: Borja Gomez <borja.gomez@datadoghq.com>
746509d to
8ead3bb
Compare
domalessi
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Left a few suggestions to tighten up and align with Datadog docs style. Let me know if you have any questions, and hit me up for re-review when ready!
|
|
||
| | Pipeline Visibility | Platform | Definition | | ||
| |-------------------------------------------------|-------------------------------------|-----------------------------------------------------------| | ||
| | [CI jobs failure analysis][21] | CI jobs failure analysis | Uses LLM models on relevant logs to analyze the root cause of failed CI jobs. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For consistency with the others.
| | [CI jobs failure analysis][21] | CI jobs failure analysis | Uses LLM models on relevant logs to analyze the root cause of failed CI jobs. | | |
| | [CI jobs failure analysis][21] | CI jobs failure analysis | Use LLM models on relevant logs to analyze the root cause of failed CI jobs. | |
| | Pipeline Visibility | Platform | Definition | | ||
| |-------------------------------------------------|-------------------------------------|-----------------------------------------------------------| | ||
| | [CI jobs failure analysis][21] | CI jobs failure analysis | Uses LLM models on relevant logs to analyze the root cause of failed CI jobs. | | ||
| | Logs correlation | Logs correlation | Correlate pipeline and job spans to logs and enable [job log collection](#collect-job-logs). | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This line reads a bit like a mix of definition + setup. Does this maintain your intention?
| | Logs correlation | Logs correlation | Correlate pipeline and job spans to logs and enable [job log collection](#collect-job-logs). | | |
| | Logs correlation | Logs correlation | Correlate pipeline and job spans with logs. Requires [job log collection](#collect-job-logs). | |
|
|
||
| Pipelines appear in Datadog immediately after CI Visibility is enabled for an organization or project. | ||
|
|
||
| <div class="alert alert-danger">If you previously configured Azure Pipelines using Service Hook Subscriptions, disable that integration before enabling CI Visibility for the same projects to avoid duplicate pipeline events. Running both integrations simultaneously does not incur additional costs, but creates duplicate data.</div> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Breaking up/tightening up a bit for clarity
| <div class="alert alert-danger">If you previously configured Azure Pipelines using Service Hook Subscriptions, disable that integration before enabling CI Visibility for the same projects to avoid duplicate pipeline events. Running both integrations simultaneously does not incur additional costs, but creates duplicate data.</div> | |
| <div class="alert alert-danger">If you previously configured Azure Pipelines using Service Hook Subscriptions, disable that integration before enabling CI Visibility for the same projects. Running both integrations simultaneously does not incur additional costs, but it creates duplicate data.</div> |
| To enable job log collection: | ||
|
|
||
| 1. Install a Datadog app registration on your Azure console. Follow the steps in the [Azure integration tile][14]. | ||
| Azure log pulling will only be enabled if you have set up the Datadog integration, which is the preferred way. To enable job log collection: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| Azure log pulling will only be enabled if you have set up the Datadog integration, which is the preferred way. To enable job log collection: |
|
|
||
| <div class="alert alert-info">Azure Log Collection is in Preview. To request access, fill out <a href="https://forms.gle/vXEQQcPLARdSDLd27">this form</a>.</div> | ||
|
|
||
| Datadog supports log collection for your Azure DevOps pipelines. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| Datadog supports log collection for your Azure DevOps pipelines. | |
| Datadog supports log collection for Azure DevOps pipelines. Log collection is enabled only after you set up the Datadog Azure DevOps integration. | |
| To enable job log collection: |
| 2. Add the Datadog app registration to your Azure DevOps organization: | ||
| <br>a. Navigate to **Organization settings** in your DevOps console. | ||
| <br>b. Click **Users** from the left side panel, then click **Add Users**.<br>**Note**: If you don't see the **Add Users** button, you may not have the necessary permissions. | ||
| 1. Set up the Datadog integration for Azure DevOps. Follow the steps in the [Azure integration tile][14]. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 1. Set up the Datadog integration for Azure DevOps. Follow the steps in the [Azure integration tile][14]. | |
| 1. Set up the Datadog Azure DevOps integration by following the steps in the [Azure integration tile][14]. |
| 2. Enable log pulling in the Datadog UI: | ||
| <br>a. Navigate to [CI Visibility Settings][23] in your Datadog account. | ||
| <br>b. Enable log pulling for Azure DevOps. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 2. Enable log pulling in the Datadog UI: | |
| <br>a. Navigate to [CI Visibility Settings][23] in your Datadog account. | |
| <br>b. Enable log pulling for Azure DevOps. | |
| 2. In Datadog, go to [CI Visibility Settings][23]. | |
| 3. Enable log pulling for Azure DevOps. |
What does this PR do? What is the motivation?
Updates Azure Pipelines CI Visibility documentation to reflect that log collection is now Generally Available (GA):
Merge instructions
Merge readiness:
Additional notes
The translated versions (JA, ES) still contain beta/preview banners - these are managed externally through the translation workflow.