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

Added detailed explanations about some metrics #364

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

amnabk
Copy link

@amnabk amnabk commented Jan 7, 2025

added a few lines in the README file explaining what some of the metrics do.

@amnabk
Copy link
Author

amnabk commented Jan 7, 2025

Hi @DrJosh9000 Can you please review my changes? Thanks!

README.md Outdated
@@ -313,8 +313,6 @@ Buildkite > (Org, Queue) > BusyAgentPercentage
Buildkite > (Org, Queue) > TotalAgentsCount
```

When a queue is specified, only that queue's metrics are published.
Copy link
Contributor

Choose a reason for hiding this comment

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

Why is this removed? Is it incorrect?

README.md Outdated

**RunningJobsCount**: This metric counts the number of jobs that are currently in the “running” state. These jobs have been picked up by agents and are actively being executed.

**UnfinishedJobsCount**: This metric includes all jobs that have been scheduled but have not yet finished. This count would include the jobs that are in the “running,” “scheduled”.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
**UnfinishedJobsCount**: This metric includes all jobs that have been scheduled but have not yet finished. This count would include the jobs that are in the “running,” “scheduled”.
**UnfinishedJobsCount**: This metric includes all jobs that have been scheduled but have not yet finished. This includes jobs in the “running” and “scheduled” states.

README.md Outdated

**ScheduledJobsCount**: This metric refers to jobs that have been scheduled but not yet started by any agent. These jobs are in the queue, waiting for an available agent to start executing them.

**WaitingJobsCount**: This metric counts jobs that are in a “waiting” state, which could mean they are waiting on dependencies to resolve, on other jobs to finish, or on any other condition that needs to be met before they can be scheduled. When a queue is specified, only that queue's metrics are published.
Copy link
Contributor

Choose a reason for hiding this comment

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

Ah, the sentence above wasn't deleted, it somehow ended up here. Move it back? where it was?

Suggested change
**WaitingJobsCount**: This metric counts jobs that are in a “waiting” state, which could mean they are waiting on dependencies to resolve, on other jobs to finish, or on any other condition that needs to be met before they can be scheduled. When a queue is specified, only that queue's metrics are published.
**WaitingJobsCount**: This metric counts jobs that are in a “waiting” state, which could mean they are waiting on dependencies to resolve, on other jobs to finish, or on any other condition that needs to be met before they can be scheduled.

README.md Outdated

**UnfinishedJobsCount**: This metric includes all jobs that have been scheduled but have not yet finished. This count would include the jobs that are in the “running,” “scheduled”.

**ScheduledJobsCount**: This metric refers to jobs that have been scheduled but not yet started by any agent. These jobs are in the queue, waiting for an available agent to start executing them.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
**ScheduledJobsCount**: This metric refers to jobs that have been scheduled but not yet started by any agent. These jobs are in the queue, waiting for an available agent to start executing them.
**ScheduledJobsCount**: This metric counts jobs that have been scheduled but are not yet started by any agent. These jobs are in the queue, waiting for an available agent to start executing them.

@amnabk amnabk marked this pull request as draft January 24, 2025 21:24
Just fixed a couple errors and changed a few words based on the suggestions!
Copy link
Author

@amnabk amnabk left a comment

Choose a reason for hiding this comment

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

Updated and fixed an error!

@amnabk amnabk marked this pull request as ready for review January 24, 2025 22:07
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