Thema
Dieser Artikel beschreibt die Protokolldateien, die von NinjaOne-Komponenten erstellt werden, wo sich diese Dateien auf verwalteten Endpunkten befinden und wie man sie zur Fehlerbehebung erfasst.
Umgebung
- NinjaOne Endpoint Management
- NinjaOne Mobile Device Management (MDM)
- NinjaOne Remote und Quick Connect
- NinjaOne OS Deployment
Beschreibung
Nach der Installation erstellen die NinjaOne-Komponenten Protokolldateien, in denen Betriebsaktivitäten, Fehler und Diagnosedaten für die auf den verwalteten Endgeräten ausgeführten Dienste aufgezeichnet werden. Wenn ein Problem auftritt, können Sie die Fehlerbehebung schneller und genauer durchführen, wenn Sie wissen, wo sich diese Dateien befinden und wie Sie sie erfassen können. Dieser Artikel fasst die Speicherorte der Protokolldateien für den NinjaOne-Agenten und die zugehörigen Komponenten auf allen unterstützten Betriebssystemen zusammen.
Wählen Sie ein Thema aus, um fortzufahren:
Speicherorte der Protokolldateien
NinjaOne-Agent
Der NinjaOne-Agent schreibt Protokolldateien auf jedem unterstützten Betriebssystem an festgelegte Speicherorte. In der folgenden Tabelle sind die Speicherorte der Protokolldateien nach Plattform aufgeführt.
| Betriebssystem | Speicherort der Protokolldateien |
|---|---|
| Microsoft Windows | C:ProgramDataNinjaRMMAgent |
| Apple macOS | /Applications/NinjaRMMAgent/programdata |
| Linux | /opt/NinjaRMMAgent/programdata/logs |
Windows
Die folgende Tabelle beschreibt die wichtigsten Protokolldateien, die sich im Windows-Verzeichnis befinden.
| Datei | Inhalt |
|---|---|
NinjaRMMAgent_<Datum>_<time>.txt |
Diese Datei protokolliert die laufenden Aktivitäten des Agenten, darunter ausgeführte Aufgaben, ausgelöste Bedingungen, Installationsereignisse und die Kommunikation zwischen dem Agenten und den NinjaOne-Servern. Jeden Tag oder bei jedem Neustart des Agenten wird eine neue Datei erstellt. Die 14 neuesten Dateien werden aufbewahrt. |
NinjaRMMPatcher_<Datum>_<time>.txt |
Das Patcher-Protokoll erfasst Aktivitäten im Zusammenhang mit Agent-Versionsaktualisierungen und fehlgeschlagenen Upgrades. |
NinjaRMMSignal_<Datum>_<time>.txt |
Der Agent schreibt Notrufe in diese Datei, wenn er ein potenzielles Problem erkennt, wie z. B. einen Absturz oder einen Verbindungsverlust. |
njlink_<xxxxx>_<Datum-Uhrzeit>.log |
Dieses Protokoll erfasst die Aktivitäten der Cloud-RDP-Verbindung. |
jsonoutput-agent.txt |
Diese Datei enthält Hardware- und Software-Inventardaten, die vom Gerät erfasst und an die NinjaOne-Server gesendet wurden, darunter Angaben zum Betriebssystem, zur installierten Software, zu Netzwerkadaptern, zu laufenden Diensten und zur Speicherkonfiguration. |
jsonoutput-output.json |
NinjaOne verwendet diese Datei, um die aktuell ausstehenden, genehmigten und abgelehnten Betriebssystem-Patches auf dem Gerät zu verfolgen. |
jsonoutput-hist-output-xxx.json |
Diese Datei protokolliert die Betriebssystem-Patches, die auf dem Gerät installiert wurden. |
jsonoutput-softwarepatchrecords2.json |
NinjaOne verwendet diese Datei, um die aktuell ausstehenden, genehmigten und abgelehnten Software-Patches von Drittanbietern auf dem Gerät zu verfolgen. |
jsonoutput-softwarepatch_history_2.json |
Diese Datei enthält Aufzeichnungen über Software-Patches von Drittanbietern, die auf dem Gerät installiert wurden. |
policyagent.config.*.json |
Diese Dateien speichern die lokal auf das Gerät angewendeten Richtlinieneinstellungen, darunter Bereiche wie Patch-Management, Virenschutz, Bedingungen, geplante Automatisierungen und Datensicherung. |
appevents.txt |
Diese Datei enthält die 500 neuesten Ereignisse aus dem Windows-Anwendungsereignisprotokoll. |
sysevents.txt |
Der Export des Systemereignisprotokolls enthält die 500 neuesten Systemereignisse. |
secevents.txt |
Der Export des Sicherheitsereignisprotokolls enthält die 500 neuesten Sicherheitsereignisse. |
macOS
„ProgramData“ standardmäßig ausgeblendet. Um ihn einzublenden, drücken Sie die Tastenkombination „Umschalt + Befehl + Punkt“. Falls diese Tastenkombination nicht funktioniert, führen Sie den folgenden Befehl in einer Terminal-Sitzung aus: defaults write com.apple.Finder AppleShowAllFiles true
Das Verzeichnis „ProgramData“ unter macOS ist in die folgenden Unterordner gegliedert.
| Unterordner | Inhalt |
|---|---|
| Protokolle | Agenten-Aktivitätsprotokolle (NinjaRMMAgent_<Datum>_<time>.txt) und Patcher-Protokolle (NinjaRMMPatcher_<Datum>_<time>.txt). |
| Jsonoutput | Hardware- und Software-Bestandsdaten, die vom Gerät erfasst und zusammen mit Patch-Datensätzen an die NinjaOne-Server gesendet werden. |
| JSON-Eingabe | Datensätze zu geplanten Automatisierungen und Aufgaben, die an das Gerät gesendet werden. |
| Richtlinie | Konfigurationsdateien, die die lokal auf dem Gerät angewendeten Richtlinieneinstellungen darstellen. |
| Patch | Patch-bezogene Ausgabedateien. |
Linux
Das Verzeichnis /opt/NinjaRMMAgent/programdata ist in die folgenden Unterordner unterteilt.
| Unterordner | Inhalt |
|---|---|
| Protokolle | Aktivitätsprotokolle des Agenten (NinjaRMMAgent_<Datum>_<time>.txt) und Patcher-Protokolle (NinjaRMMPatcher_<Datum>_<time>.txt). |
| Jsonoutput | Hardware- und Software-Bestandsdaten, die vom Gerät erfasst und zusammen mit Patch-Datensätzen an die NinjaOne-Server gesendet werden. |
| Richtlinie | Konfigurationsdateien, die die lokal auf dem Gerät angewendeten Richtlinien-Einstellungen darstellen. |
NinjaOne Mobile Device Management (MDM)
Tippen Sie in der NinjaOne MDM Assist-App 7–9 Mal schnell hintereinander auf das NinjaOne-Logo. Die App wechselt in den QA-Modus. Tippen Sie auf die Schaltfläche „Netzwerkprotokolle“, die am unteren Bildschirmrand erscheint. Die App zeigt die Protokolle im Klartext an. Tippen Sie auf die Schaltfläche „Protokolle exportieren“, um die Protokolle in eine Freigabe-App zu exportieren.
NinjaOne Remote
NinjaOne Remote generiert Protokolldateien für seine Streaming- und Wiedergabekomponenten. In der folgenden Tabelle sind die Speicherorte der Protokolldateien nach Betriebssystem aufgeführt.
| Betriebssystem | Speicherort der Protokolldatei |
|---|---|
| Windows |
|
| macOS |
NCstreamer und NCplayer: Navigieren Sie zu /Applications/NinjaRemote/logs NCPlayer. Von dort aus navigieren Sie zu dem Speicherort, der in der Umgebungsvariablen $TMPDIR hinterlegt ist. (Beispiel: /var/folders/v1/<<temp_folder_name>>/T)
|
| Linux |
|
Quick Connect
NinjaOne Quick Connect schreibt Protokolldateien an den folgenden Speicherorten auf Windows- und macOS-Endpunkten:
| Betriebssystem | Speicherort der Protokolldatei |
|---|---|
| Windows | C:BenutzerÖffentlichNinjaOneLLCQClogs |
| macOS | Benutzer/Gemeinsam genutzt/NinjaRMM |
Betriebssystem-Bereitstellung
NinjaOne OS Deployment schreibt Protokolldateien an folgenden Speicherort auf Windows-Endgeräten: C:ProgramDataNinjaOSDeploy
Erfassen von NinjaOne-Agent-Protokolldateien
Sie können die Protokolldateien des NinjaOne-Agenten mithilfe der unten beschriebenen Methoden erfassen. Die Erfassungsmethode unterscheidet sich je nach Betriebssystem.
Windows
Um Protokolldateien auf einem Windows-Endpunkt zu erfassen, führen Sie den folgenden Befehl in einer Eingabeaufforderung mit erhöhten Rechten aus. Ersetzen Sie [OrganizationName-Version] durch den Namen Ihrer Organisation und die Versionsnummer aus Ihrem Agent-Installationsordner.
C:Program Files (x86)[OrganizationName-Version]ninjarmmagent.exe /collectlogsAlternativ können Sie, falls Ihr Agent am Standardpfad installiert ist, folgenden Befehl ausführen:
C:Program Files (x86)Ninjaoneninjarmmagent.exe /collectlogsDiese Befehle weisen NinjaOne an, die gesammelte Protokolldatei am folgenden Speicherort zu speichern:
C:WindowsTempninjalogs.cabmacOS
Um Protokolldateien auf einem macOS-Endpunkt zu erfassen, komprimieren Sie die folgenden Ordner aus dem Verzeichnis „NinjaRMM Agent → ProgramData“ und senden Sie sie an Ihren Support-Ansprechpartner:
- Protokolle
- Policy
- Jsonoutput
- Jsoninput
- Patch
Linux
Um Protokolldateien auf einem Linux-Endpunkt zu erfassen, komprimieren Sie die folgenden Ordner aus dem Verzeichnis /opt/NinjaRMMAgent/programdata und senden Sie diese an Ihren Support-Ansprechpartner:
- Protokolle
- Richtlinie
- Jsonoutput