Hygiene
Hygiene reports can help you understand the health of your Issue Management and Support systems, like Jira or Zendesk. These reports look at how well you're following best practices for managing issues. They check things like how you classify issues and how quickly you respond to them.
By using hygiene reports, you can see where your process is working well and where there are problems that may be causing delays in your deployments. Hygiene reports give you important data to improve your issue management practices and deliver a better experience for your customers.
Popular Hygiene reports
The following are the most commonly used Hygiene reports.
Issue Hygiene report
Definition
The Issue Hygiene report in SEI provides valuable insights into how well your team is following issue management best practices.
The report shows your overall hygiene score and individual scores for each hygiene category. It assigns a scorecard to each issue, grading it against a set of hygiene categories. Scores represent hygiene misses in the designated time frame. A hygiene miss means that a ticket in your issue management system was missing an important field, failed to change status in a timely manner, or was assigned to an inactive user.
Overall Hygiene Score
The Overall Hygiene Score gives you a comprehensive view of the health of your issue management system. This score represents the percentage of tickets that meet your defined hygiene standards. A higher score indicates better issue hygiene, with a score of 100 meaning that no tickets were missing any important hygiene data.
The Overall Hygiene Score is calculated as follows:
Individual Hygiene Category Scores
The Issue Hygiene Report also provides detailed scores for each hygiene category, allowing you to pinpoint specific areas of concern. The available hygiene categories are:
Idle: Tickets that have not been updated for a specified period of time (e.g., 30 days or more).
Poor Description: Tickets with descriptions that contain fewer than a specified number of characters (e.g., 10 characters).
No Due Date: Tickets without a due date populated.
No Assignee: Tickets without an assignee populated.
No Components: Tickets without any components populated.
Missed Response Time: Tickets that failed to change status before the goal response time expired.
Missed Resolution Time: Tickets that were not in a resolved status before the goal resolution time expired.
Inactive Assignees: Tickets assigned to inactive users.
You can also configure custom hygiene categories by setting up Custom Hygiene Misses in your Issue Management Platform integrations. You can modify the importance of each category when you configure the Issue Hygiene Report.
You can measure sprint hygiene scores also with the Issue Hygiene Trend Report.
Add the report
To configure the Issue Hygiene report, follow these steps:
Step 1: Add the widget
Go to the Insight where you want to add the widget, Select Settings, then Add Widget.
Choose the Issue Hygiene report widget.
The following settings are available to configure this report:
Step 2: Configure the Filters on the widget
Add additional conditions to specify what data feeds into the widget by creating inclusive and exclusive filters.
If you include multiple filters, they are inherently combined with an
ANDoperator.
EARLY ACCESS FEATURE
The ability to select specific sprints or the current sprint at the widget level is currently in BETA. Contact Harness Support to enable this feature.
When the Feature Flag / Entitlement is enabled for the SEI account you can:
Define the criteria for considering sprints under the Filters section. You have two options: you can either include the current sprint or filter by the last sprint.
You can also manually select the sprints for which you want to configure the widget.
Step 3: Define the Weights for each Hygiene Category
Configure the Weights for each hygiene category.
A lower weight causes a category to have a lower impact on the overall score, and a higher weight causes a category to have a larger impact on the overall score. A weight of zero excludes that category from the hygiene score calculation. Make sure the total of all weights equals 100.
In addition to the built-in categories, you can add custom hygiene categories by configuring Custom Hygiene Misses in your issue management SEI integrations.
Step 4: Configure the Settings
Select the Issue Management System to use for this widget. Available options are based on your configured SEI integrations.
The Issue Hygiene Report is often used along with the Issue Hygiene Trend Report to show a history of hygiene scores.
Complete the widget settings and select Next: Place Widget, place the widget on Insight and then select Save Layout.
Common use cases
Here are some examples of configurations for the Issue Hygiene report widget.
Issue Hygiene Trend report
Definition
The Issue Hygiene Trend report provides a view of the historical performance of your issue management practices. This report displays the trend of individual scores for each hygiene category, allowing you to analyze the evolution of your issue hygiene over time. This report can help you answer questions about your issue hygiene, such as:
How have your issue classification practices changed over the past few quarters?
Are there specific hygiene categories where your team's performance has been inconsistent or declining?
How do your current issue hygiene metrics compare to the targets or benchmarks you've set for your organization?
By understanding these historical trends, you can make informed decisions to optimize your issue management processes and ensure the consistent implementation of effective hygiene practices across your engineering team.
Add the report
To configure the Issue Hygiene Trend report, follow these steps:
Step 1: Add the widget
Select Settings, then Add Widget.
Choose the Issue Hygiene Trend report widget.
The following settings are available to configure this report:
Step 2: Configure the Filters for the widget
Add additional conditions to specify what data feeds into the widget by creating inclusive and exclusive filters.
If you include multiple filters, they are inherently combined with an
ANDoperator.
Step 3: Define the Weights for each Hygiene Category
Configure the Weights for each hygiene category.
A lower weight causes a category to have a lower impact on the overall score, and a higher weight causes a category to have a larger impact on the overall score. A weight of zero excludes that category from the hygiene score calculation. Make sure the total of all weights equals 100.
In addition to the built-in categories, you can add custom hygiene categories by configuring Custom Hygiene Misses in your issue management SEI integrations.
Step 4: Configure the Settings
Select the Issue Management System to use for this widget. Available options are based on your configured SEI integrations.
Select the Time Interval for the data to be displayed in the widget.
Select how you want to display the data in the widget. The available options are Stacked Area Chart and Stacked Bar Chart
Select Next: Place Widget, place the widget on Insight and then select Save Layout.
Support Hygiene reports
Support Hygiene Reports provide valuable insights into the quality and efficiency of your customer support operations. These reports focus on analyzing the hygiene of your support tickets across multiple areas.
Support Hygiene Report: This report measures the overall quality of the support backlog based on various hygiene factors or categories, such as:
Ticket description quality
Presence of contact information
Idle time between ticket updates
Adherence to escalation protocols
Overall ticket resolution effectiveness
By evaluating support tickets against these hygiene criteria, the report helps identify areas for improvement in your customer support processes.
Support Hygiene Trend Report: The Support Hygiene Trend Report allows you to observe changes in support hygiene scores over time. This enables you to:
Track the impact of process improvements or training initiatives on support quality
Identify recurring problem areas that require deeper investigation
Benchmark your support hygiene metrics against organizational targets or industry standards
These support hygiene reports are similar in functionality and configuration to the Issue Hygiene Reports, providing a holistic view of how effectively your organization is delivering high-quality customer support.
Last updated
