Näkymässä Ylläpito voit avata lokipuun, tarkastella lokiyhteyksiä ja ladata lokeja.

Efecten Service Management Tool luo laajan valikoiman lokeja eri tarkoituksiin. Lokitiedostojen kohde, enimmäiskoko ja lokien kierrätys voidaan määrittää asiakkaan tarpeiden mukaan.

Seuraavat lokit luodaan oletuksena:

• Security log: Tallentaa kaikki tietoturvan kannalta olennaiset tapahtumat, kuten käyttäjien sisään- ja uloskirjautumiset sekä työnkulkujen hyväksynnät
• Configuration log: Tallentaa ylläpitokäyttöliittymässä tehdyt muutokset ratkaisun konfiguraatioon
• Integration log: Kirjaa Web API:hin liittyvät tapahtumat, jotka koskevat tietojen tuontia ja vientiä
• Application error log: Tallentaa sovelluspalvelimeen liittyvät virheet ja varoitukset
• Data card access log (valinnainen, erikseen lisensoitava ominaisuus): Tallentaa kaikki korttien katselukerrat sekä listanäkymässä että yksityiskohtaisessa näkymässä niille malleille, joille ominaisuus on määritetty.
• M42 Intelligence log: Kirjaa, mitä AI-ominaisuuksia käytetään. Tähän kuuluvat Writing assistance ja Action triggers. Oletuslokitaso on INFO. Saatavilla on seuraavat tiedot:
  • Ominaisuustiedot.
  • Käyttäjän yksilöllinen tunniste yksittäisten / palaavien käyttäjien seurantaan.
  • Aikaleima.
  • Mallin nimi.
  • Pyynnön tokenien määrä.

Lokien lataaminen

Jotta lokitiedostoja voidaan ladata ESM:n käyttöliittymästä Download logs -toiminnolla, alustan asetus log.files on ensin määritettävä. Se kertoo ESM:lle, mitkä lokitiedostot tulee ladata. Alustan asetuksia voi muokata kohdasta Maintenance > Edit settings. Lisää haluamiesi lokitiedostojen tai -kansioiden sijainnit asetuksen arvoiksi. Jos arvo on kansio, kaikki sen sisältämät tiedostot ladataan.

Lokipuu

Lokipuun avulla voit seurata lokeja reaaliajassa. Lokit näytetään hierarkkisena puuna. Puun juuressa olevaa lokia napsauttamalla voit seurata kaikkia lokeja niiden nykyisellä lokitasolla. Voit myös hakea tiettyä komponenttia ja nostaa sen lokitasoa. Tämä on yleensä tarpeen, kun etsit ongelman syytä.

Lokiyhteydet

Log connections -toiminnolla voit tarkastella luetteloa lokipuun avoimista yhteyksistä.

Lokin ominaisuuksien muokkaaminen käyttöliittymässä

Voit muokata lokin ominaisuuksia näkymässä, joka avautuu, kun napsautat lokipuussa jotakin lokia.

Näkymässä näet valitun lokin nimen. Level-kentän ylös- ja alas-nuolilla voit muuttaa lokitiedostoon \Efecte\log tallennettavien lokien lokitasoa. Taso näytetään nuolten jälkeen.

Jos haluat lähettää viestin tarkistaaksesi, että lokitus toimii valitulla tasolla, napsauta Send test message -painiketta.

Voit vaihtaa näkymässä näytettävän reaaliaikaisen lokitason valitsemalla sopivan tason avattavasta valikosta. Käytettävissä olevat tasot (vähiten yksityiskohtaisesta eniten yksityiskohtaiseen) ovat:

• Fatal
• Error
• Warn
• Info
• Debug
• Trace

Poistaaksesi lokit vain näkymästä, napsauta Clear -painiketta. Itse lokitiedostoa ei tyhjennetä.

Pysäyttääksesi reaaliaikaisten lokien päivittymisen näkymässä, napsauta Disconnect-painiketta.

Sulkeaksesi näkymän, napsauta Close-painiketta.

Lokiominaisuuksien muokkaaminen

Ylläpitäjät voivat määrittää oman lokituskäytäntönsä tiedostossa nimeltä custom-log.properties, joka sijaitsee on-premise-käyttöönotossa polussa installationDIR/Webapp/WEB-INF/. Siellä määritetty kiertokäytäntö (rolling policy) korvaa oletuskäytännön. Jos esimerkiksi ESM on asennettu on-premise-ympäristöön hakemistoon /opt/efecte_le ja Webapp-tunnus on efecte, käytännön tulisi sijaita tiedostossa /opt/efecte_le/efecte/WEB-INF/custom-log.properties.

Vaihtoehtoisesti pilviympäristöissä: /var/lib/efecteone/tenant_files/xxx/itsm/files/itsm/WEB-INF/custom-log.properties

Tomcatin uudelleenkäynnistys tarvitaan, jotta muutokset tiedostoon custom-log.properties päivittyvät.

Jos asiakas ei määritä omaa custom-log.properties-tiedostoa yllä kuvatulla tavalla, ESM käyttää omaa oletusresurssitiedostoaan custom-log.properties. Tiedostossa custom-log.properties voidaan määrittää kaksi erilaista kiertokäytäntöä aikavälin tai muistikoon rajan perusteella: TimeBaseRollingPolicy ja SizedBasedTriggeredTriggeringPolicy

Lokiasetusten muokkaaminen alustan asetuksissa

Lokiasetuksilla on oma osionsa alustan asetuksissa. ESM asennetaan oletuksena ConsoleAppender-tilassa. Muita lokitusmekanismeja voidaan ottaa käyttöön tekemällä asianmukaisia muutoksia (esim. lokitiedoston sijaintiin) asetusten arvoihin. Kattavat ohjeet log4j-asetusten määrittämiseen löytyvät log4j:n verkko-ohjeista osoitteesta http://logging.apache.org/log4j/1.2/manual.html.

Session Log -esimerkki
Jos haluat esimerkiksi seurata ESM-käyttäjien istuntoja, voit käyttää SessionLoggeria ja määrittää sen seuraavien ohjeiden mukaisesti:

1. Siirry kohtaan Maintenance > System settings > Edit Platform settings.
2. Etsi ja ota käyttöön nämä 5 asetusta (oletusarvoilla) napsauttamalla asetuksen edessä olevaa valintaruutua:
   1. log4j.logger.com.bitmount.boas.log.SessionLogger
   2. log4j.appender.session
   3. log4j.appender.session.layout
   4. log4j.appender.session.layout.ConversionPattern (tämä oletusarvo kannattaa muuttaa myös alustan asetuksissa, jotta ei synny yhtä valtavaa tiedostoa vaan vuosittainen tai neljännesvuosittainen tiedosto).
   5. log4j.appender.session.File
3. Käynnistä ESM- / Efecte Tomcat -palvelu uudelleen.
4. Tarkista, että session.log voidaan ladata kohdasta Maintenance > Logs > Download logs
5. Lataa ja avaa session.log-tiedosto Muistiossa (Notepad) nähdäksesi käyttäjätunnukset, sisään- ja uloskirjautumisajat, istuntojen kokonaiskestot ja käyttäjäkorttien sijainnin ESM:n käyttöoikeuspuussa:
   1. LOGIN aB6UArhznRMgTtXrxV TestUser
   2. LOGOUT aB6UArhznRMgTtXrxV TestUser 15.06.2006 13:51 15.06.2006 13:51 0 min Main Users
   3. LOGIN aB6UArhznRMgTtXrxV root
   4. LOGOUT aB6UArhznRMgTtXrxV root 15.06.2006 14:01 15.06.2006 14:05 3 min
   5. LOGIN aB6UArhznRMgTtXrxV aradams
   6. LOGIN ak8-km3bhTZhgYSxxV gesmith
   7. LOGOUT aB6UArhznRMgTtXrxV aradams 15.06.2006 14:05 15.06.2006 14:06 1 min Basic Users
   8. LOGOUT ak8-km3bhTZhgYSxxV gesmith 15.06.2006 14:06 15.06.2006 14:10 4 min Basic Users
6. Jos haluat nähdä myös käyttäjien lisenssityypin, ja Floating-lisenssit halutaan rajata yhteen käyttäjäryhmään, voit siirtää kaikki Floating write -lisenssit ja niiden käyttäjät uuteen alikansioon nimeltä "Floating users" Licenses & Permissions -puissa. Voit myös nimetä oletuskansion "Users" uudelleen nimelle "Dedicated users" ja siirtää kaikki dedicated-lisenssit sinne.