09. Synctool Logging

Inleiding

Dit gedeelte beschrijft hoe je event logging kunt aanpassen, recente logs en evenementen kunt bekijken of geautomatiseerde logoverzichten per e-mail kunt instellen. Deze functies zijn gegroepeerd onder het tabblad Logging in de Synctool-gebruikersinterface.

Sommige logs of evenementen kunnen dubbel worden weergegeven in de Synctool-logs en -evenementen
De Zivver Synctool voert een proef-synchronisatie uit voordat een daadwerkelijke synchronisatie plaatsvindt. De proef-synchronisatie kan ervoor zorgen dat log- of evenemententries voor een specifieke gebruiker dubbel worden weergegeven.

Email Reporting

Bij Email Reporting stel je een geautomatiseerd e-mailrapport in, zodat je updates ontvangt in je mailbox van Synctool-synchronisaties. Zivver raadt aan om e-mailrapportage in te stellen, omdat dit de beheerder op de hoogte brengt van eventuele synchronisatiefouten zonder dat je hoeft in te loggen op de Synctool-server om fouten in de synchronisatielogs te zoeken.

Je bepaalt door de bijbehorende vakjes aan te vinken of je alleen e-mailrapporten wilt ontvangen in geval van fouten of elke keer dat de Synctool is uitgevoerd volgens schema en zonder toezicht.

Standaard wordt er geen e-mailrapport verzonden, dus de eerste stap is om het vakje bij Send sync results by email aan te vinken.

  • SMTP Relay Host
    Dit is de Host Name van de SMTP Relay Host, bijvoorbeeld smtp.example.org of smtp.office365.com, of het IP-adres van de relay host. Dit is een verplicht veld.

  • Port
    Deze poort wordt gebruikt voor SMTP-verkeer. Vul 587 in (aanbevolen) of gebruik poort 25. Dit is een verplicht veld.

  • Use TLS
    Vink het vakje aan als je TLS wilt gebruiken.

  • User Name
    Als je moet authenticeren bij de SMTP Relay Host, vul dan de gebruikersnaam voor authenticatie in. Dit is mogelijk niet nodig.

  • Password
    Als je moet authenticeren bij de SMTP Relay Host, vul dan het wachtwoord in dat bij de gebruikersnaam hoort voor authenticatie. Dit is mogelijk niet nodig.

  • From Address
    Voer een e-mailadres in dat de afzender van de e-mailrapporten zal zijn. Dit kan een fictief adres zijn, zoals synctool@your-organization-domain.com. Dit is een verplicht veld. Ontvangers ontvangen de e-mailrapporten van dit (fictieve) adres.

  • Recipients
    Voer het e-mailadres in dat het rapport moet ontvangen. Dit kan een persoonlijk of gedeelde mailbox zijn. Als je meerdere adressen wilt toevoegen, scheid ze dan met een puntkomma ; of voeg elk nieuw adres op een nieuwe regel toe. Dit is een verplicht veld.

  • Send test mail
    Verzend een testmail om te testen of je een bericht kunt verzenden vanaf de Synctool-server naar de ontvangers.

    Als de testmail mislukt
    Als de testmail mislukt, raadpleeg dan je Exchange-beheerder of de documentatie van je mailserver over hoe je SMTP-berichten kunt doorsturen.
  • Mail only in case of errors
    Vink dit vakje aan als je alleen e-mail wilt ontvangen wanneer er een fout optreedt tijdens de synchronisatie. Zivver raadt aan deze functie in te schakelen.

  • Mail only when in Silent Mode (recommended)
    Vink dit vakje aan als je e-mail wilt ontvangen wanneer de Synctool volgens schema en zonder toezicht is uitgevoerd. Bijvoorbeeld door de Windows Taakplanner.

Event Logging

Bij Event Logging schakel je de opties in om evenementen naar een bestand te schrijven, naar het Windows Events Log te sturen en een evenementoverzicht te maken.

Write events to a file

Schakel Write events to file in en specificeer een map door op Browse te klikken. Het logbestand bevat de status van hoe een account is verwerkt tijdens die synchronisatie.

Schrijf eventbestanden in de Synctool-map
Best practice is om de eventbestanden op te slaan in de map waar je de Synctool hebt opgeslagen. Bijvoorbeeld, als je de Synctool hebt opgeslagen in C:\Program Files\Zivver.Synctool, maak dan een map genaamd Logs aan. Zo kun je de eventlogs opslaan in C:\Program Files\Zivver.Synctool\Logs.

Als je Write events to file inschakelt maar geen map opgeeft, worden de eventbestanden opgeslagen in de map die het Synctool-profiel bevat.

Als je Write events to file niet inschakelt, wordt er na het uitvoeren van een synchronisatie geen eventbestand opgeslagen.

Write events summary to a file

Schakel Write events summary to file in en specificeer een map door op Browse te klikken. De samenvatting bevat alleen het aantal uitgevoerde mutaties, hoeveel daarvan succesvol waren en hoeveel er zijn mislukt.

Schrijf samenvattingsbestanden van evenementen in de Synctool-map
Best practice is om de samenvattingen van evenementen op te slaan op dezelfde locatie waar je de eventlogs hebt opgeslagen. Bijvoorbeeld, als je de logs hebt opgeslagen in C:\Program Files\Zivver.Synctool\Logs, maak dan een map genaamd Summary aan. Zo kun je de samenvattings-logs opslaan in C:\Program Files\Zivver.Synctool\Logs\Summary.

Als je Write events summary to file inschakelt maar geen map opgeeft, worden de samenvattingsbestanden opgeslagen in de map die het Synctool-profiel bevat.

Als je Write events summary to file niet inschakelt, wordt er na het uitvoeren van een synchronisatie geen samenvattingsbestand opgeslagen.

Write events to Windows Event Log

Schakel Write events to the Windows Events Log in als je Windows Events al in een derde partij-applicatie (bijv. Splunk) monitort en de Synctool-evenementen ook in die applicatie wilt volgen.

Recent Logs

Bij Recent Logs vind je gedetailleerde logs over achtergrondprocessen van de Synctool. Als je tegen synchronisatieproblemen aanloopt, kun je de bijbehorende logs op dit tabblad vinden. De logs zijn gesorteerd op zes verschillende niveaus:

  • Trace
  • Debug
  • Warning
  • Error
  • Fatal
Logs worden opgeslagen in je Roaming AppData
De Zivver Synctool-applicatielogs worden opgeslagen in %AppData%\Roaming\Zivver\SyncTool\Logs. De bestandsnaam is zivver_synctool_app.log en dit bestand mag niet groter zijn dan 50 MB. Als zivver_synctool_app.log 50 MB bereikt, wordt er een nieuw logbestand aangemaakt en wordt het huidige bestand hernoemd naar zivver_synctool_app.log.bck. Het bestand zivver_synctool_app.log.bck wordt overschreven wanneer zivver_synctool_app.log opnieuw 50 MB groot is.

Recent Events

Bij Recent Events kun je de achtergrondprocessen van de Synctool zien voor de laatste uitgevoerde actie, zoals handmatige synchronisaties, wijzigingen previewen of bronnen previewen.

De items die worden weergegeven in Recent Events bevatten informatie over het laden, parseren en saneren van brongegevens. Recent Events kunnen je helpen te identificeren waar in een proces iets fout is gegaan.