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
- Gestione degli endpoint NinjaOne
- NinjaOne Mobile Device Management (MDM)
- NinjaOne Remote e 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 l'accuratezza della risoluzione. Questo articolo riassume le posizioni dei file di log per l'agente NinjaOne e i componenti correlati nei 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 | Percorso del file di log |
|---|---|
| Microsoft Windows | C:ProgramDataNinjaRMMAgent |
| Apple macOS | /Applicazioni/NinjaRMMAgent/programdata |
| Linux | /opt/NinjaRMMAgent/programdata/logs |
Windows
La tabella seguente descrive i principali file di log presenti nella directory di Windows.
| File | Contenuto |
|---|---|
NinjaRMMAgent_<data>_<time>.txt |
Questo file registra l'attività corrente dell'agente, comprese le attività eseguite, le condizioni attivate, gli eventi di installazione e le comunicazioni tra l'agente e i server NinjaOne. Ogni giorno o al riavvio dell'agente viene creato un nuovo file. 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 arresto anomalo o la 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 storage. |
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 aspetti 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 true
La directory "ProgramData " di macOS è organizzata nelle seguenti sottocartelle.
| Sottocartella | Contenuto |
|---|---|
| Log | Log delle 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 e delle attività pianificate inviate al dispositivo. |
| Policy | 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 di 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. |
| Policy | File di configurazione che rappresentano le impostazioni delle politiche applicate localmente al dispositivo. |
NinjaOne Mobile Device Management (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.
NinjaOne Remote
NinjaOne Remote genera file di log per i propri componenti di streaming e riproduzione. La tabella seguente elenca i percorsi dei file di log in base al sistema operativo.
| Sistema operativo | Percorso del file di log |
|---|---|
| Windows |
|
| macOS |
NCstreamer e NCplayer: accedere a /Applications/NinjaRemote/logs NCPlayer. Da lì, accedere alla posizione memorizzata nella variabile d'ambiente $TMPDIR. (Ad esempio: /var/folders/v1/<<nome_cartella_temp>>/T)
|
| Linux |
|
Quick Connect
NinjaOne Quick Connect scrive i file di log nelle seguenti posizioni sugli endpoint Windows e macOS:
| Sistema operativo | Percorso del file di log |
|---|---|
| Windows | C:UsersPublicNinjaOneLLCQClogs |
| macOS | Utenti/Condivisi/NinjaRMM |
Distribuzione del sistema operativo
NinjaOne OS Deployment 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:Program Files (x86)[OrganizationName-Version]ninjarmmagent.exe /collectlogsIn alternativa, se l’agente è installato nella posizione predefinita, eseguire:
C:Program Files (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, comprimi le seguenti cartelle presenti nella directory NinjaRMM Agent → ProgramData e inviale al tuo referente dell'assistenza:
- Logs
- Policy
- 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
- Policy
- Jsonoutput