Argomento
Questo articolo descrive i file di log generati dai componenti di NinjaOne, la loro posizione sugli endpoint gestiti e come raccoglierli a scopo di risoluzione dei problemi.
Ambiente
- NinjaOne Endpoint management
- NinjaOne Gestione dei dispositivi mobili (MDM)
- Ninja Remote e Ninja Quick Connect
- Distribuzione del sistema operativo NinjaOne
Descrizione
Dopo l'installazione, i componenti di NinjaOne generano file di log che registrano l'attività operativa, gli errori e i dati diagnostici relativi ai servizi in esecuzione sugli endpoint gestiti. Quando si verifica un problema, sapere dove trovare questi file e come raccoglierli aumenta la velocità e la precisione della risoluzione. Questo articolo riporta in modo sintetico le posizioni dei file di log per l'agente NinjaOne e i componenti correlati su tutti i sistemi operativi supportati.
Seleziona un argomento per continuare:
Posizioni dei file di log
Agente NinjaOne
L'agente NinjaOne scrive i file di log in posizioni fisse su ciascun sistema operativo supportato. La tabella seguente elenca le posizioni dei file di log per piattaforma.
| Sistema operativo | Posizione del file di log |
|---|---|
| Microsoft Windows | C:ProgramDataNinjaRMMAgent |
| Apple macOS | /Applicazioni/NinjaRMMAgent/ProgramData |
| Linux | /opt/NinjaRMMAgent/ProgramData/Log |
Windows
La tabella seguente descrive i principali file di log presenti nella Directory di Windows.
| File | Sommario |
|---|---|
NinjaRMMAgent_<DATA>_<TIME>.txt | Questo file registra l’attività corrente dell’agente, incluse le attività eseguite, le condizioni attivate, gli eventi di installazione e le comunicazioni tra l’agente e i server NinjaOne. Viene creato un nuovo file ogni giorno o al riavvio dell’agente. Vengono conservati i 14 file più recenti. |
NinjaRMMPatcher_<DATA>_<TIME>.txt | Il log del patcher registra le attività relative agli aggiornamenti di versione dell'agente e agli errori di aggiornamento. |
NinjaRMMSignal_<DATA>_<TIME>.txt | L’agente scrive segnali di emergenza in questo file quando rileva un potenziale problema, come un crash o una perdita di connettività. |
njlink_<XXXXX>_<DATA-ora>.log | Questo log registra l’attività di connessione Cloud RDP. |
jsonoutput-agent.txt | Questo file contiene i dati di inventario hardware e software raccolti dal dispositivo e inviati ai server NinjaOne, inclusi i dettagli del sistema operativo, il software installato, le schede di rete, i servizi in esecuzione e la configurazione dello spazio di archiviazione. |
jsonoutput-output.json | NinjaOne utilizza questo file per tenere traccia delle patch del sistema operativo attualmente in sospeso, approvate e rifiutate sul dispositivo. |
jsonoutput-hist-output-xxx.json | Questo file registra le patch del sistema operativo che sono state installate sul dispositivo. |
jsonoutput-softwarepatchrecords2.json | NinjaOne utilizza questo file per tenere traccia delle patch software di terze parti attualmente in sospeso, approvate e rifiutate sul dispositivo. |
jsonoutput-softwarepatch_history_2.json | Questo file registra le patch software di terze parti che sono state installate sul dispositivo. |
policyagent.config.*.json | Questi file memorizzano localmente le impostazioni dei criteri applicate al dispositivo, relative ad aree quali la gestione delle patch, l'Antivirus, le condizioni, le automazioni pianificate e il backup. |
appevents.txt | Questo file contiene i 500 eventi più recenti del Registro eventi delle applicazioni di Windows. |
sysevents.txt | L'esportazione del Registro eventi di sistema contiene i 500 eventi di sistema più recenti. |
secevents.txt | L'esportazione del registro eventi di sicurezza contiene i 500 eventi di sicurezza più recenti. |
macOS
"ProgramData" è nascosta per impostazione predefinita. Per renderla visibile, premi Maiusc + Comando + Punto. Se questa scorciatoia non funziona, esegui il seguente comando in una sessione di Terminale: defaults write com.apple.Finder AppleShowAllFiles trueLa directory "ProgramData " di macOS è organizzata nelle seguenti sottocartelle.
| Sottocartella | Sommario |
|---|---|
| Log | Log attività dell’agente (NinjaRMMAgent_<DATA>_<TIME>.txt) e log del patcher (NinjaRMMPatcher_<DATA>_<TIME>.txt). |
| Jsonoutput | Dati di inventario hardware e software raccolti dal dispositivo e inviati ai server NinjaOne, insieme ai record delle patch. |
| Input JSON | Registrazioni delle automazioni programmate e delle attività programmate inviate al dispositivo. |
| Criterio | File di configurazione che rappresentano le impostazioni delle politiche applicate localmente al dispositivo. |
| Patch | File di output relativi alle patch. |
Linux
La directory /opt/NinjaRMMAgent/programdata è organizzata nelle seguenti sottocartelle.
| Sottocartella | Contenuto |
|---|---|
| Log | Log attività dell'agente (NinjaRMMAgent_<DATA>_<TIME>.txt) e log del patcher (NinjaRMMPatcher_<DATA>_<TIME>.txt). |
| Jsonoutput | Dati di inventario hardware e software raccolti dal dispositivo e inviati ai server NinjaOne, insieme ai record delle patch. |
| Criterio | File di configurazione che rappresentano le impostazioni delle politiche applicate localmente al dispositivo. |
NinjaOne Gestione dei dispositivi mobili (MDM)
Nell’app NinjaOne MDM Assist, toccare rapidamente il logo NinjaOne 7-9 volte. L’app entrerà in Modalità QA. Fare clic sul pulsante “Log di rete”, che apparirà nella parte inferiore dello schermo. L’app visualizzerà i log in testo semplice. Fare clic sul pulsante “Esporta log” per esportare i log in un’applicazione di condivisione.
Ninja Remote
Ninja Remote genera file di log per i suoi componenti di streaming e riproduzione. La tabella seguente elenca le posizioni dei file di log in base al sistema operativo.
| OS | Percorso del file di log |
|---|---|
| Windows |
|
| macOS | NCstreamer e NCplayer: andare su /Applications/NinjaRemote/logs NCPlayer. Da lì, andare alla posizione memorizzata nella variabile d'ambiente $TMPDIR. (Ad esempio: /var/folders/v1/<<NOME_CARTELLA_TEMP>>/T) |
| Linux |
|
Ninja Quick Connect
NinjaOne Quick Connect scrive i file di log nelle seguenti posizioni sugli endpoint Windows e macOS:
| Sistema operativo | Posizione del file di log |
|---|---|
| Windows | C:UsersPublicNinjaOneLLCQClogs |
| macOS | Utenti/Condivisi/NinjaRMM |
Distribuzione del sistema operativo
NinjaOne OS Distribuzione scrive i file di log nella seguente posizione sugli endpoint Windows: C:ProgramDataNinjaOSDeploy
Raccolta dei file di log dell’agente NinjaOne
È possibile raccogliere i file di log dell’agente NinjaOne utilizzando i metodi descritti di seguito. Il metodo di raccolta varia a seconda del sistema operativo.
Windows
Per raccogliere i file di log su un endpoint Windows, eseguire il seguente comando in un prompt dei comandi con privilegi elevati. Sostituire [OrganizationName-Version] con il nome dell’organizzazione e il numero di versione presenti nella cartella di installazione dell’agente.
C:Programmi (x86)[OrganizationName-Versione]ninjarmmagent.exe /collectlogsIn alternativa, se l’agente è installato nella posizione predefinita, eseguire:
C:Programmi (x86)Ninjaoneninjarmmagent.exe /collectlogsQuesti comandi indicano a NinjaOne di salvare il file di log raccolto nella seguente posizione:
C:WindowsTempninjalogs.cabmacOS
Per raccogliere i file di log su un endpoint macOS, comprimere le seguenti cartelle presenti nella directory NinjaRMM Agent → ProgramData e inviarle al proprio referente dell'assistenza:
- Log
- Criterio
- Jsonoutput
- Input JSON
- Patch
Linux
Per raccogliere i file di log su un endpoint Linux, comprimere le seguenti cartelle dalla directory /opt/NinjaRMMAgent/programdata e inviarle al proprio referente dell'assistenza:
- Log
- Criterio
- Jsonoutput