Problem Management Procedure

How the Organisation identifies, classifies, investigates and closes problems, keeps a known error database and workarounds, and prevents incidents from recurring.

SXL-SM18Procedure2,606 words 12 min readOwner: Problem Manager
Sign in to download the PDFFree. You return straight to this document after you sign in.
Template draft. Replace everything in [square brackets] with your own decision, delete what does not describe what you really do, and approve it through your own document control. It is not legal advice and does not make an organisation compliant or certified.

1. Introduction

A problem is the cause, or the suspected cause, of one or more incidents. Incident management restores service; problem management finds out why it failed, removes that cause where it is worth doing so, and keeps users working in the meantime through documented workarounds.

This procedure covers reactive work, which starts from incidents, and proactive work, which starts from trends, monitoring and review findings before users are harmed. It works with the Problem Management Policy and Process of the information security management system, which sets the security view of recurring weaknesses.

2. Purpose

This procedure reduces the number and impact of incidents by identifying their causes, recording what is known about them, and following each problem to a permanent fix, an accepted risk, or a recorded decision not to act. It makes sure that effort goes to the problems that matter most, that investigations use proven methods, and that what is learned reaches the people who handle the next incident.

3. Objectives

  • Open a problem record for every major incident, every cause that recurs [three] times in [30 days], and every trend that crosses a threshold.
  • Complete root cause analysis within the target for the problem priority, and record the cause in a way that others can verify.
  • Maintain a known error database in which every open known error has a tested workaround or a stated reason why none exists.
  • Resolve problems through the Change Management Procedure and verify that the incident count falls afterwards.
  • Reduce repeat incidents on the same cause by [20%] each year.
  • Close no problem without evidence that the cause is removed, or without a decision signed by the service owner.

4. Scope

  • In scope: problems affecting any service in the service catalogue, whether the cause lies in infrastructure, applications, processes, people, documentation or suppliers.
  • In scope: proactive analysis of incident trends, monitoring data, audit findings and customer complaints.
  • Out of scope: restoring service (see the Service Incident Management Procedure) and carrying out the fix, which is a change.
  • Applies to: the problem manager, service desk, resolver groups, service owners, the change authority, and suppliers who own a cause.

5. Terms and definitions

TermMeaning
ProblemThe cause, or potential cause, of one or more incidents.
Known errorA problem whose root cause has been identified and for which a workaround or permanent fix is documented.
Known error databaseThe record of known errors, their workarounds and their status, available to the service desk and resolver groups.
WorkaroundA documented way to reduce or remove the effect of a problem without removing its cause.
Root cause analysisA structured investigation that finds the underlying cause rather than the symptom.
Post-incident reviewA review held after a major incident, whose actions may open problem records.
Permanent fixA change that removes the cause so the incident cannot recur from it.

6. Roles and Responsibilities

RoleResponsibilities
Process ownerOwns this procedure, sets priority and target rules, and sponsors the review of open problems every [quarter].
Problem managerRuns the process, opens and prioritises problems, assigns owners, facilitates analysis, maintains the known error database and reports.
Problem ownerA named person from the right resolver group who leads the investigation and resolution of one problem.
Service deskLinks incidents to problems, uses known error records during diagnosis, and reports repeat symptoms.
Resolver groupsSupply technical analysis, test workarounds and implement fixes through change management.
Service ownerDecides whether the cost of a permanent fix is justified against the risk, and accepts the residual risk when it is not.
Change authorityAssesses and approves the changes that implement fixes, giving priority to changes that remove known causes.
Configuration managerSupplies relationship and history data on affected configuration items, and updates records after a fix.
Supplier managerBrings suppliers into analysis for causes that lie outside the Organisation, and applies the contract.
Top managementReceives the report on high-priority problems and releases resources for fixes that need funding.
ActivityResponsibleAccountableConsultedInformed
Identify and log problemsProblem managerProcess ownerService desk, Resolver groupsService owner
Classify and prioritiseProblem managerProcess ownerService ownerResolver groups
Perform root cause analysisProblem ownerProblem managerResolver groups, Configuration managerService owner
Maintain the known error databaseProblem managerProcess ownerResolver groups, Service deskService owner
Decide on a permanent fixService ownerTop managementProblem owner, Change authorityProblem manager
Implement the fix through change managementResolver groupsChange authorityProblem ownerService desk
Close the problemProblem managerService ownerProblem ownerService desk
Report and reviewProblem managerProcess ownerService ownersTop management

7. Problem Management Process

7.1 Inputs and outputs

InputsOutputs
Incident records, especially major and repeat incidentsProblem records with owner, priority and status
Monitoring data, alerts and capacity or availability trendsRoot cause analysis report
Post-incident review actionsKnown error records and workarounds
Audit findings, customer complaints and supplier reportsRequests for change that remove causes
Configuration records and change historyUpdated knowledge for the service desk
Supplier root cause reportsClosed problems with verification evidence

7.2 Identifying problems

Problems are identified by six routes. The problem manager reviews the list weekly and may open a record on judgement as well as on a rule.

SourceTriggerAction
Major incidentAny major incidentOpen a problem within [1 business day] of closure of the incident
Repeat incidents[Three] incidents with the same symptom or configuration item in [30 days]Open a problem and link all incidents
Trend analysisCategory count up by [25%] on the previous three monthsOpen a problem for the leading sub-category
MonitoringRecurrent alert, capacity or performance warning without an incidentOpen a proactive problem
Supplier or releaseSupplier notice of a defect, or a release with unexplained post-release incidentsOpen a problem and involve the supplier manager
Reviews and auditsFinding that points to a systemic weaknessOpen a problem or link the finding to an existing one

7.3 Logging

  1. Create the recordThe problem manager opens a problem record in [the ticketing tool] with a clear title that names the symptom and the service, not a guess at the cause.
  2. LinkAll related incidents, changes, alerts and configuration items are linked. The number of incidents and the total user hours lost are recorded.
  3. Search the known error databaseIf a known error matches, the problem is linked to it. If its workaround has not worked, the problem is raised in priority.
  4. AssignA problem owner is named within [2 business days]; a problem with no owner may not be classified as closed or as deferred.

7.4 Classification and prioritisation

Problems are classified by category, using the incident categories, and by origin: application, infrastructure, process, supplier, design or human factor. Priority is set from the effect and the frequency of the incidents it causes, and from the risk if it is not resolved.

PriorityCriteriaAnalysis startsRoot cause targetReview
CriticalCaused a major incident, or puts a customer commitment or personal data at risk[Immediately][5 business days][Weekly]
High[Five or more] incidents in a month or a P1 or P2 incident with no workaround[1 business day][10 business days][Fortnightly]
MediumRecurring incidents with a workaround; moderate cost to users[5 business days][20 business days][Monthly]
LowFew incidents, easy workaround, low effect[When capacity allows][40 business days][Quarterly]

7.5 Root cause analysis

The problem owner selects a method to fit the problem and records it, with the evidence used. The method is chosen for the type of failure; complex problems often use more than one.

MethodUse it whenHow it works
Five whysThe failure is simple and the chain of cause is shortAsk why of each answer until a cause is found that the Organisation can act on, usually five levels or fewer; record each answer with its evidence.
Cause and effect diagramMany possible causes across people, process, technology and environmentGroup possible causes under headings, then test each against evidence to rule them in or out.
Timeline analysisThe failure followed a series of events or changesBuild a timed sequence from logs, changes and tickets and look for the first deviation.
Change analysisService worked before and failed after a changeCompare the state before and after on every changed configuration item; test by reversing the change in a safe environment.
Fault tree analysisA serious failure with several contributing eventsWork from the top failure down through the combinations of events that could have caused it.
Pareto analysisChoosing which problem to tackle first from manyRank problems by incidents or hours lost; start with the few that cause most of the harm.
  1. Plan the analysisThe problem owner sets the questions, the data to collect, the people to involve and the date of the findings meeting.
  2. Gather evidenceLogs, configuration history, change records, test results and supplier reports are collected and kept with the record. Where personal data or security evidence is involved, handling follows the Information Security Management for Services procedure.
  3. Find the causeThe method is applied, hypotheses are tested, and the cause is recorded with evidence that proves it. A suspected cause is labelled as suspected.
  4. ReviewThe problem manager and one person who was not part of the analysis review the findings for gaps before the cause is accepted.

7.6 Known errors and workarounds

A problem becomes a known error when its root cause is identified, or when a workaround is found that can reduce the effect of the incidents even if the cause is not yet known. Every known error is entered in the known error database.

FieldContent
Known error number and linked problemIdentifier of the known error and its problem record
SymptomsWhat the user or monitoring shows, in the words a service desk analyst would meet
CauseRoot cause as far as known, or suspected cause
WorkaroundTested steps, who may apply them, side effects, and the date last tested
StatusOpen, fix planned, fix released, closed
Review date[3 months] after entry for open items, so that stale workarounds are found
  • The problem manager tests the workaround with a resolver group before publishing it; an untested workaround is labelled as such.
  • Analysts must check the known error database before diagnosing an incident, and link the incident to the known error when it matches.
  • A workaround that needs elevated access is applied by the resolver group, not the service desk.
  • Known errors are reviewed every [3 months]; those with no fix after [12 months] are put to the service owner for a decision to fix or accept.

7.7 Resolution through change

  1. Propose the fixThe problem owner writes the proposed fix, its cost, its risk, and the effect on incidents if it is not done.
  2. DecideThe service owner decides to fix, to defer to a named date, or to accept the risk. A decision to accept is recorded with the person's name and expires after [12 months].
  3. Raise a changeThe problem owner raises a request for change under the Change Management Procedure, linked to the problem, and requests priority where the problem is Critical or High.
  4. Implement and releaseThe fix is built, tested and released through the Release and Deployment Management Procedure.
  5. VerifyAfter the fix, the problem manager watches the linked incident category for [30 days] or [one full business cycle]. If the incident recurs, the problem is reopened.

7.8 Closure

  1. Check the evidenceThe problem manager checks that the cause is documented, the fix was released and verified, the known error is updated or closed, and linked incidents are annotated.
  2. ApproveThe service owner signs the closure for Critical and High problems. For Medium and Low problems the problem manager may close with the problem owner's agreement.
  3. Share lessonsThe problem manager adds the lessons learned to knowledge articles, change models, training notes or monitoring rules, and records where this was done.
  4. RecordThe record is closed with a closure code: fixed, risk accepted, no cause found, or suspended with review date.

7.9 Process flow

  1. A source (major incident, repeat incident, trend, monitoring, supplier or review) shows a possible problem.
  2. The problem manager logs the problem, links incidents and checks the known error database.
  3. The problem is classified, prioritised and given a problem owner.
  4. The owner performs root cause analysis and the findings are reviewed.
  5. If the cause or a workaround is known, a known error record is entered and published.
  6. The service owner decides on a permanent fix, deferral or acceptance of the risk.
  7. The fix goes through change management and release management.
  8. The problem manager verifies that incidents have fallen, closes the problem and shares lessons.
  9. Open problems and known errors are reviewed on their schedule and reported monthly.

8. Interfaces with Other Processes

ProcessInterface
Service Incident Management ProcedureSupplies incident data; receives workarounds and known errors; major incident reviews open problems.
Change Management ProcedureFixes are made as changes; failed changes can themselves become problems.
Release and Deployment Management ProcedureReleases deliver fixes; defects found after release open problems.
Configuration and Asset Management ProcedureProvides relationships and history for analysis; updated after fixes.
Service Level Management ProcedureProblem targets and recurring breaches feed service reviews with customers.
Availability and Service Continuity Management ProcedureAvailability trends open proactive problems; fixes support availability targets.
Supplier Management ProcedureSupplier causes are pursued under the contract.

9. Key Performance Indicators

MeasureTargetSourceFrequency
Major incidents with a problem record opened within 1 business day[100%]Problem register[Monthly]
Root cause found within target, by priority[90%]Problem register[Monthly]
Known errors with a tested workaround[95%]Known error database[Monthly]
Incidents linked to a known error at the time of resolution[At least 80% of matching incidents]Sample of incident records[Monthly]
Repeat incidents on a closed problem within 90 days[Below 5%][Ticketing tool] report[Quarterly]
Reduction in incidents of the leading three categories[10% per quarter][Ticketing tool] report[Quarterly]
Open problems older than 90 days without a dated decision[Zero]Problem register[Monthly]
Risk acceptances past their expiry[Zero]Problem register[Quarterly]

10. Records and Evidence

RecordKept inRetention
Problem records with analysis, evidence and decisions[The ticketing tool][5 years]
Known error database entries[Knowledge base][Until closed, then 3 years]
Root cause analysis reports[Document management system][5 years]
Risk acceptance decisions for problems[Risk register][Until expiry plus 3 years]
Monthly and quarterly problem reports[Document management system][3 years]

Annexure A: Problem record

FieldEntry
Problem number[Generated by the ticketing tool]
Title (symptom and service)
Raised by and date
Source (major incident, repeat, trend, monitoring, supplier, review)
Linked incidents and number
Configuration items affected
Category and origin
Priority and reason
Problem owner and resolver group
Business effect (users, hours lost, customers)
Workaround in use
Root cause and evidence
Known error number
Decision on fix (fix, defer, accept) and approver
Linked change and release
Verification result and date
Closure code and date

Annexure B: Root cause analysis report

SectionContent
Problem number and title
Date of analysis and participants
Summary of the failure and its effect
Method used and why
Timeline of events, with sources
Evidence examined (logs, changes, tests)
Direct cause
Root cause
Contributing factors
What was ruled out, and why
Corrective and preventive actions (owner, date)
Reviewed by and date

Annexure C: Known error record

FieldEntry
Known error number and linked problem
Symptoms
Cause
Workaround steps and who may apply them
Date workaround last tested and by whom
Status and expected fix date
Next review date

Annexure: Document history

VersionDateAuthorSummary of changeApproved by
1.0[dd-mm-yyyy][Author]Initial issue from the SecureXcel template[Approver]

11. Exception

Exceptions to this document are allowed only where compliance is not practicable and the risk has been assessed. A request must state what is to be excepted, why, the risk it creates, the compensating controls, and an end date no later than [6 months]. It is approved in writing by the document owner and the risk owner, recorded in the exceptions register, and reviewed at the end date. An exception does not change the document.

12. Enforcement

Compliance is monitored through internal audits, management review and routine checks by the document owner. Non-compliance is reported through the incident or non-conformity process and handled under the organisation's disciplinary procedure, and under the terms of any contract for people who are not employees. Serious or repeated non-compliance may lead to loss of access and, where the law is broken, to referral to the authorities.

13. Review

This document is reviewed at least every [12 months], and when there is a significant change to the organisation, its systems, its risks or the law, or after an incident that shows it was not effective. Each review is recorded in the revision history.

ISO/IEC 20000-1:2018 references

ReferenceTitle
8.6.3Problem management
8.6.1Incident management
8.5.1Change management
10.2Continual improvement
8.1Operational planning and control
Sign in to download the PDFFree. You return straight to this document after you sign in.