Skip to content
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

PORT-11788 DORA Metrics - additional tracking ways #1851

Open
wants to merge 11 commits into
base: main
Choose a base branch
from

Conversation

kodjomiles
Copy link
Contributor

Description

Added some additional ways to track deployment, calculate lead time for change and measure change failure rate for in the dora metrics guide leveraging on Jira.

Updated docs pages

Please also include the path for the updated docs

  • Dora Metrics guide (/guides/all/setup-dora-metrics)

@kodjomiles kodjomiles self-assigned this Dec 11, 2024
Copy link

This pull request is automatically being deployed by Amplify Hosting (learn more).

Access this pull request here: https://pr-1851.d2ngvl90zqbob8.amplifyapp.com

kodjomiles and others added 3 commits December 16, 2024 10:29
Refined the DORA metrics setup guide by reworking the structure and adding alternative tracking methods, including Jira-based deployment tracking, lead time tracking, CFR using high-priority bugs, and hotfix deployments. Improved section clarity and alignment to recommended practices for tracking incidents and metrics.
@kodjomiles kodjomiles marked this pull request as ready for review December 16, 2024 23:13
The link to the Jira integration guide was incorrect. Updated the path from "issue-tracking" to "project-management" to ensure accurate navigation for users.
kodjomiles and others added 4 commits December 18, 2024 09:16
…proaches using Jira. Enhanced incident tracking section with alternative methods, tabs for clarity, and improved formatting. These changes aim to improve usability and comprehension without altering functionality.
@Matanga1-2
Copy link
Contributor

@kodjomiles @hadar-co I highly recommend to start split this guide into files for readability. it's way too long.
For example

  • CI/CD deployments
  • PR merged
  • Incident management tools

Its really hard to understand the guide (technically) in its current structure (the UI shouldnt' change, just files structure)


:::

### Tracking lead time with Jira tickets
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This feels out of place. We discuss on tracking deployments and instead we're talking about lead tim

@@ -886,25 +924,71 @@ By this method, individual services within a monorepo are mapped to Port bluepri
Custom integrations provide flexibility in mapping and tracking each service or microservice within a monorepo. With Port’s API, you can track deployments and updates for each component separately, giving you granular control over monitoring and managing services in a monorepo.
:::

### Tracking deployment via Jira tickets (Alternative)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why don't we put it with the other tracking strategis?


Ensure that your **PagerDuty incident blueprint** is properly configured to map incidents to the correct services(gitHub).
<TabItem value="recommended" label="Recommended">
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why not have tab items like "Incident management tools" ,"Jira", "Hotfix deployment"

</TabItem>

</Tabs>


## Metrics
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe I'm missing but no where we explain how the aggregation correlate with the alternative methods. e.g., if I use Jira to track lead time

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants