Mit dem Protokoll arbeiten
Das Business Portals - Log unterstützt Administratoren dabei, Meldungen zu Portalaktivitäten zu prüfen und Probleme zu untersuchen. Einträge können Fehler, Warnungen oder Informationen zu abgeschlossenen Vorgängen enthalten.
Das Protokoll öffnen
- Öffnen Sie in Business Central das Rollencenter Business Portals Administrator.
- Suchen Sie unter Activities den Bereich Business Portals Logs.
- Wählen Sie eine der Kacheln oder die daneben angezeigte Aktionskachel Logs:
| Kachel oder Aktion | Beschreibung |
|---|---|
| Aktionskachel Logs | Öffnet alle gelesenen und ungelesenen Einträge des aktuellen Unternehmens, ohne eine Anzahl anzuzeigen. |
| Zählkachel Unread Logs | Zeigt die Anzahl aller ungelesenen Einträge einschließlich Fehlern, Warnungen und Informationen und öffnet diese Einträge im aktuellen Unternehmen. |
| Zählkachel Error Logs | Zeigt die Anzahl ungelesener Fehler und öffnet nur diese Einträge im aktuellen Unternehmen. Die rote Kennzeichnung hebt Fehler hervor, die Aufmerksamkeit erfordern. |
Sie können auch über die Suche in Business Central die Seite Business Portals - Log öffnen. Die neuesten Einträge stehen oben. Aktualisieren Sie die Seite, um aktuelle Zählerstände und Meldungen anzuzeigen.
Info
Für den Zugriff auf Diagnoseprotokolle sind Administratorberechtigungen erforderlich. Wenden Sie sich an Ihren Business Central-Administrator, wenn Sie die Seite nicht öffnen können.
Die Protokollkacheln und die Aktion verwenden
Die Zählkacheln und die Aktionskachel Logs werden gemeinsam unter Activities im Administrator-Rollencenter angezeigt. Die Zählkacheln geben einen schnellen Überblick über noch nicht bestätigte Meldungen. Alle Anzahlen und Listen beziehen sich auf das aktuelle Unternehmen.
Unread Logs: Alle unbestätigten Meldungen prüfen
Unread Logs zählt ungelesene Einträge aller Typen: Fehler, Warnungen und Informationen. Verwenden Sie diese Kachel, um alle neuen Meldungen zu prüfen, auch Statusinformationen, bei denen keine Korrektur erforderlich ist.
- Wählen Sie Unread Logs oder die angezeigte Zahl.
- Business Portals - Log öffnet sich mit dem Filter Read = No.
- Prüfen Sie Type und Source, um das Ereignis und den meldenden Prozess zu erkennen.
- Wählen Sie eine Meldung und anschließend Details, um die vollständigen Informationen anzuzeigen, sofern verfügbar.
- Markieren Sie die geprüfte Meldung über Read Status als gelesen oder lassen Sie sie für weitere Untersuchungen ungelesen.
Error Logs: Ungelesene Fehler gezielt prüfen
Error Logs zählt nur Einträge, die sowohl ungelesen als auch vom Typ Error sind. Die rote Kennzeichnung lenkt die Aufmerksamkeit auf diese Kategorie. Verwenden Sie diese Kachel, um zuerst Fehler und danach Warnungen und Informationen zu prüfen.
- Wählen Sie Error Logs oder die angezeigte Zahl.
- Das Protokoll öffnet sich mit Read = No und Type = Error.
- Prüfen Sie Source, User, Portal User und die Beschreibungen, um Prozess und Benutzer zu erkennen. Nicht jeder Prozess liefert einen Portalbenutzernamen.
- Öffnen Sie Details. Prüfen Sie bei Einträgen mit Wiederholungszählung Occurrence Count und Last Occurred, um Häufigkeit und Zeitpunkt des letzten Auftretens zu erkennen.
- Untersuchen Sie das Problem oder geben Sie die Informationen an Ihren Supportkontakt weiter. Bestätigen Sie die Meldung anschließend, wenn dies angemessen ist.
Info
Error Logs ist eine Teilmenge von Unread Logs. Bei 5 ungelesenen Einträgen, davon 2 Fehlern, zeigt Unread Logs 5 und Error Logs 2. Es handelt sich nicht um sieben verschiedene Einträge. 0 bedeutet, dass kein Eintrag den Filtern dieser Kachel entspricht. Dies bestätigt nicht, dass alle Portalprozesse fehlerfrei funktionieren.
Logs: Den vollständigen Verlauf öffnen
Logs ist eine Aktionskachel neben den Zählkacheln, ohne eigene Überschrift oder Anzahl. Sie öffnet alle Einträge des aktuellen Unternehmens einschließlich bereits gelesener Meldungen. Verwenden Sie sie, um ältere Meldungen zu finden, die Bestätigung durch andere Administratoren zu prüfen oder nach einer gefilterten Ansicht wieder die vollständige Liste zu öffnen.
Kehren Sie im Administrator-Rollencenter zu Activities zurück und wählen Sie Logs. Die Kachel enthält ein Symbol statt einer Zahl und hat keine eigene Gruppenüberschrift. Je nach Bildschirmbreite zeigt Business Central sie neben oder unter den Zählkacheln an.
Die vollständige Liste enthält dieselben Eintragsinformationen wie die gefilterten Ansichten. Das Öffnen ändert den Lesestatus nicht. Sie können auch nach Business Portals - Log suchen.
Änderungen der Zähler verstehen
- Das Öffnen einer Kachel oder von Details markiert keine Meldung als gelesen.
- Sobald ein Administrator einen Eintrag als gelesen markiert, wird er in keiner der beiden Zählkacheln mehr mitgezählt. Bei einem ungelesenen Fehler sinken deshalb beide Anzahlen.
- Wird ein gelesener Eintrag als ungelesen markiert, erscheint er wieder in Unread Logs und bei Typ Error zusätzlich in Error Logs.
- Die Kacheln zählen Einträge, nicht deren Wiederholungen. Ein ungelesener Fehler mit 20 Vorkommen zählt in jeder Kachel als 1.
- Bei Einträgen mit Wiederholungszählung kann derselbe Eintrag gemäß der 30-Minuten-Regel wieder ungelesen werden.
Aktualisieren Sie das Rollencenter nach der Prüfung oder nach Änderungen durch andere Administratoren. Aktualisieren Sie eine bereits geöffnete Protokollseite, um aktuelle Eintragsdetails zu sehen.
Die Einträge verstehen
| Feld | Beschreibung |
|---|---|
| Read | Zeigt, ob ein Administrator den Eintrag bestätigt hat. Der Status gilt gemeinsam für alle Administratoren. |
| Date and Time | Zeitpunkt der erstmaligen Erstellung. |
| Occurrence Count | Anzahl passender gemeldeter Vorkommen, sofern der Prozess Wiederholungen zählt. |
| Last Occurred | Zeitpunkt des zuletzt gemeldeten passenden Ereignisses, sofern Wiederholungen gezählt werden. |
| Type | Kennzeichnet Fehler, Warnungen oder Informationen. |
| Source | Meldender Bereich von Business Portals, beispielsweise Power BI. |
| User | Business Central-Benutzer oder Dienstkonto, das den Eintrag erfasst hat. |
| Portal User | Zugehöriger Portalbenutzer, sofern verfügbar. Kann von User abweichen. |
| Description 1–5 | Meldung, verteilt über mehrere Spalten. Wählen Sie Details für die vollständige Meldung, sofern verfügbar. |
Verschiedene Business Portals-Prozesse verwenden dasselbe Protokoll. Lesestatus und Leseaktionen gelten für alle Einträge. Manche Prozesse zählen wiederholte Ereignisse in einem Eintrag, andere erstellen einzelne Meldungen. Ältere Einträge und Einträge ohne Wiederholungszählung können 0 und ein leeres Feld Last Occurred anzeigen.
Eine Meldung untersuchen
- Wählen Sie den betreffenden Eintrag.
- Öffnen Sie Details. Dadurch wird der Eintrag nicht als gelesen markiert.
- Prüfen Sie Source, User, Portal User und die Beschreibung. Welche Informationen verfügbar sind, hängt vom meldenden Prozess ab.
- Untersuchen Sie das Problem oder geben Sie die Details an Ihren Administrator oder Supportkontakt weiter.
- Wählen Sie nach der Prüfung Read Status und Mark as Read.
Important
Als gelesen markieren bedeutet, die Meldung zu bestätigen. Das Problem wird dadurch nicht behoben und die korrekte Funktion des betroffenen Prozesses nicht bestätigt.
Bei einem nicht angezeigten Bericht siehe Power BI-Bericht kann nicht angezeigt werden.
Wiederholte Meldungen bearbeiten
Bei Prozessen mit gemeinsamer Wiederholungszählung aktualisiert Business Portals den passenden Eintrag, statt jedes Mal eine neue Zeile zu erstellen:
- Occurrence Count steigt.
- Last Occurred zeigt das neueste gemeldete Vorkommen.
- Date and Time und die ursprüngliche Meldung bleiben erhalten.
Beispiel: Wiederholte Power BI-Fehler
Power BI ist ein Beispiel für die Wiederholungszählung. Beim Aktualisieren eines Dashboards kann derselbe Berichtsfehler erneut gemeldet werden. Fehler werden zusammengefasst, wenn Portalbenutzer, Dataset, Tabelle und Fehler übereinstimmen. Andere Anfragereferenzen oder Zeitstempel allein erzeugen keinen neuen Eintrag. Ein anderer Fehler, Portalbenutzer, ein anderes Dataset oder eine andere Tabelle kann sofort einen eigenen ungelesenen Eintrag erzeugen.
Gezählt werden gemeldete Fehler, nicht Dashboardaufrufe. Der Zähler steigt nur, wenn Business Central einen weiteren passenden Fehler erhält. Aktualisieren Sie die Protokollseite, um Änderungen zu sehen.
Die 30-Minuten-Regel
Diese Bestätigungsregel gilt für Einträge mit Wiederholungszählung. Solange ein Eintrag ungelesen ist, aktualisieren passende Vorkommen denselben Eintrag.
Markiert ein Administrator den Eintrag als gelesen, beginnt ab dieser Bestätigung ein Zeitraum von 30 Minuten. Passende Vorkommen erhöhen weiterhin den Zähler und aktualisieren Last Occurred, der Eintrag bleibt jedoch gelesen. So bleibt Zeit zur Untersuchung, ohne dass dieselbe Meldung sofort wieder ungelesen wird.
Wird dasselbe Ereignis mindestens 30 Minuten nach der Bestätigung erneut gemeldet, wird der bestehende Eintrag wieder ungelesen. Der Zähler steigt weiter; es entsteht kein neuer Eintrag.
| Beispielzeit | Ereignis | Ergebnis |
|---|---|---|
| 09:00 | Ein Prozess mit Wiederholungszählung meldet erstmals einen Fehler. | Ein ungelesener Eintrag mit Anzahl 1 entsteht. |
| 09:05 | Ein Administrator wählt Mark as Read. | Der Eintrag wird gelesen. Die 30 Minuten beginnen. |
| 09:10 | Derselbe Fehler wird erneut gemeldet. | Anzahl 2; Last Occurred wird aktualisiert. Der Eintrag bleibt gelesen. |
| 09:35 | Es wurde kein weiterer Fehler gemeldet. | Der Eintrag bleibt gelesen. Der Zeitablauf allein ändert den Status nicht. |
| 09:36 | Derselbe Fehler wird erneut gemeldet. | Anzahl 3; der Eintrag wird wieder ungelesen. |
Info
Die Regel gilt nur für passende Wiederholungen eines als gelesen markierten Eintrags. Andere Fehler oder Meldungen werden niemals verzögert. Prozesse mit einzelnen Meldungen fassen Einträge nicht nach dieser Regel zusammen. Erneutes Markieren als gelesen startet die 30 Minuten neu.
Den Lesestatus verwalten
Unter Read Status stehen folgende Aktionen zur Verfügung:
| Aktion | Beschreibung |
|---|---|
| Mark as Read | Bestätigt ausgewählte Einträge für alle Administratoren. Bei Wiederholungszählung beginnen die oben beschriebenen 30 Minuten. |
| Mark as Unread | Setzt ausgewählte Einträge für alle Administratoren wieder auf ungelesen. |
| Mark All as Read | Fragt nach einer Bestätigung und markiert dann alle Einträge des aktuellen Unternehmens als gelesen, auch durch Filter ausgeblendete Einträge. |
Das Öffnen von Unread Logs, Auswählen einer Zeile oder Anzeigen von Details bestätigt keine Meldung automatisch.
Gelesene Einträge löschen
- Prüfen Sie die betreffenden Einträge und markieren Sie sie als gelesen.
- Wählen Sie Clear History.
- Lesen Sie die Bestätigung und bestätigen Sie nur, wenn diese gelesenen Einträge nicht mehr benötigt werden.
Clear History löscht alle gelesenen Einträge des aktuellen Unternehmens, auch außerhalb der Auswahl oder Filter. Ungelesene Einträge bleiben erhalten. Die Aktion erfordert die Berechtigung zum Löschen von Protokolleinträgen.
Warning
Gelöschte Einträge stehen für Untersuchungen nicht mehr zur Verfügung. Sichern Sie benötigte Supportinformationen vorher. Wird dasselbe Ereignis nach dem Löschen erneut gemeldet, entsteht ein neuer Eintrag.