Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Find an error by its reference

Step by step - when a citizen or colleague reports an error page with a reference such as ERR-0123456789, find the log line and all lines of that request in the log viewer or with exp:logs, and hand it to developers.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/government/tasks/operations/find-an-error-by-its-reference.md

On this page

Find an error by its reference

This task is for service-desk staff and administrators. An Exponential error page shows a reference such as ERR-0123456789; the same reference is in the log line, so a report from a citizen leads straight to the cause. Guide: Finding an error by its reference.

Contents

  1. Before you start
  2. In the administration
  3. On the shell
  4. Next steps
  5. Related pages

Before you start

  • The reference from the report (ask the citizen for it and the time; a screenshot helps).
  • setup/logs, or shell access.

In the administration

  1. Setup > Log files.
  2. Search for the reference (the search accepts an error reference) across the kernel logs, with rotations if the report is older.
  3. Open the line: the viewer shows the message, file and line, and the other lines of the same request, linked to the audit records of the same minute.
  4. Copy permalink for the ticket.

On the shell

./console exp:logs --reference=ERR-0123456789

It says where the reference is and prints the lines of its request. Exit 0 found, 1 not found.

Next steps

Line saysDo
a template or code errordeveloper ticket with the permalink
a database errorDatabase unreachable
a missing file or permissionCheck file and directory permissions
not found at allthe report may be from another server or engine; search there, or with --rotations for older logs

Reply to the citizen without technical detail; personal data in the report stays in your ticket system.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x