Appearance
Loggning — Radering och export
Systemloggar för flexite lagras i databasen och går att läsa i flexiteCLIENT under System > Loggar (se manualen för flexiteCLIENT Systemadministration). Loggar för arbete med registreringar går även att läsa i detaljvyn för de individuella registreringarna i flexiteWEB (se manualen för flexiteWEB).
Loggar för flexiteProcessEngine lagras på disk.
Dessa loggar lagras som standard för evigt med möjlighet att per loggtyp ange hur länge de ska behållas.
Det är även möjligt att per loggtyp ange huruvida de ska exporteras till textfiler samt hur länge de exporterade loggarna ska behållas.
Loggtyper
- ProcessEngine och DLL loggar — flexiteProcessEngine, flexites systemtjänster samt standard-DLL och systemspecifika integrationer skriver loggar direkt till disk.
- Användarsessioner och säkerhetshändelser — Loggar användares in- och utloggning i flexiteCLIENT samt flexiteWEB samt säkerhetsaktioner kopplade till användarkonton. Ålder på sessioner räknas från tidpunkt för inloggning. Detta kan i extrema fall resultera i att loggposten för en pågående session raderas om den aktuella sessionen är aktiv längre än angivet antal dagar för Radera loggar efter … dagar.
Loggar kan läsas i flexiteCLIENT under:
System > Loggar > Åtkomstloggar > Användarsessioner
System > Loggar > Åtkomstloggar > Säkerhet - Registreringar — Loggar aktiviteter som sker i och med en registrering i flexiteWEB. Dessa loggar raderas aldrig.
Loggar kan läsas i flexiteCLIENT under System > Loggar > Händelseloggar > Arbete. Loggar för individuella registreringar kan även läsas i detaljvyn för den aktuella registreringen i flexiteWEB. - Sökningar — Loggar sökningar utförda i flexiteWEB.
Loggar kan läsas i flexiteCLIENT under System > Loggar > Händelseloggar > Sökningar. - Ändringar i rättighetsgrupper — Loggar förändringar i rättigheter för grupper.
Loggar kan läsas i flexiteCLIENT under System > Loggar > Konfigurationsloggar > Ändringar i rättighetsgrupper. - Förändringar i process och organisation — Loggar ändringar gjorda i processer samt ändringar gjorda i organisationen som påverkar processen.
Loggar kan läsas i flexiteCLIENT under System > Loggar > Konfigurationsloggar > Förändringar i process och organisation. - Gallring — Loggar ändringar av gallringsinställningar per attribut.
Loggar kan läsas i flexiteCLIENT under System > Loggar > Konfigurationsloggar > Gallringsförändringar. - flexiteDB-link användar- och objektimport — Loggar för integrationsuppgifter av typerna Användarimport och Objektimport.
Loggar för dessa integrationsuppgifter nås via länk i e-post till loggmottagare, angiven på respektive uppgift.
Loggar för exekvering av flexiteDB-Link uppgifter lagras av flexiteProcessEngine på disk och hanteras av konfiguration för ProcessEngine och DLL loggar. - Förändringar av användarkonton — Loggar förändringar av användarkonton och ändringar i grupptillhörighet.
Loggar kan läsas i flexiteCLIENT under System > Loggar > Konfigurationsloggar > Förändringar av användarkonton. - E-postmeddelanden — Loggar för utgående e-post.
Loggar kan läsas i flexiteCLIENT under System > Loggar > Händelseloggar > E-postmeddelanden.
Loggar för e-posttjänsten (MailSvc) lagras av flexiteProcessEngine på disk och hanteras av konfiguration för ProcessEngine och DLL loggar. - System — Loggar för systemförändringar och systemtekniska fel.
Loggar kan läsas i flexiteCLIENT under:
System > Loggar > Händelseloggar > System
System > Loggar > Konfigurationsloggar > Systemförändringar
Radering och lagringstid för loggar i databas
Loggar i databasen lagras som standard för evigt. I flexiteCLIENT är det möjligt att per loggtyp ange hur många dagar som dessa loggar ska lagras innan de raderas. Konfiguration av loggning utförs under Inställningar > Loggning och automatisk utplåning > Konfigurera loggning.
- Radera loggar efter ... dagar — Radera loggar i databasen som är äldre än angivet antal dagar.
Avancerad konfiguration
Radering av loggposter i databasen utförs löpande utav den flexiteProcessEngine som kör tjänsten MailSvc alternativt OnHoldSvc. Denna radering utförs i sjok (så kallade chunks) med en paus mellan sjoken. Detta för att minimera tiden som databastabellerna låses av operationen, och därmed hindrar andra operationer från att skriva till dem.
Som standard är antalet loggposter i en chunk 10 000, med 5 sekunders paus mellan chunks.
Anpassa Chunk Size
Radering av loggposter utförs som standard per loggtyp i så kallade chunks med en paus mellan dessa chunks. Standardkonfigurationen av antalet loggposter i en chunk (10 000) samt tiden mellan chunks (5 sekunder) är framtagen för att nå en bra balans mellan låg tidsåtgång för löpande radering och minimal påverkan på normal drift. Hantering av en chunk med 10 000 loggposter slutförs i normala fall inom cirka 1 till 2 sekunder, men denna tidsåtgång kan variera beroende på prestanda på databasservern.
Medan operationen för att radera loggar körs låses databastabellerna för dessa loggar, vilket betyder att det inte är möjligt att skriva nya poster till dessa tabeller under denna tid. Skrivning av nya poster kommer att köas och köras när operationen för radering av aktuell chunk är slutförd.
Storleken på dessa chunks och tiden mellan chunks styrs av parametern DeleteLogsChunkSize i konfigurationsfilen för flexiteProcessEngine (flexiteProcessEngine.ini). Om parametern saknas används standardvärdet om 10.000 loggposter i en chunk och 5 sekunders paus mellan chunks.
Parameter i flexiteProcessEngine.ini:
ini
[Database.0]
DeleteLogsChunkSize=Värden för DeleteLogsChunkSize
| Värde | Beskrivning |
|---|---|
{chunkSize},{timeBetweenChunks} | Exempel:
Standardvärde: |
disable | Inaktivera radering av loggar på aktuell flexiteProcessEngine. |
max | Radera samtliga loggar i ett svep utan att dela upp dem i chunks. Notera att detta kan resultera i att de tabeller i databasen som låses av loggraderingen inte kan skrivas till under lång tid, beroende på antal loggposter. Det är därmed rekommenderat att enbart nyttja detta värde vid den initiala aktiveringen av loggradering i det fall det finns en stor mängd loggposter att radera. |
Funktionalitet vid avsaknad av eller inkorrekt värde
Om parametern DeleteLogsChunkSize saknas fullständigt i filen flexiteProcessEngine.ini används standardvärdet om 10 000 loggposter i en chunk och 5 sekunders paus mellan chunks.
Om parametern existerar i filen men saknar värde likställs detta med värdet disable, vilket medför att radering av loggar inaktiveras på aktuell flexiteProcessEngine.
Om parametern existerar i filen men har ett inkorrekt värde som inte matchar ovan beskrivna format likställs detta med värdet disable, vilket medför att radering av loggar inaktiveras på aktuell flexiteProcessEngine.
Rekommendation vid initial aktivering i befintligt system
I det fall radering av loggar aktiveras i ett befintligt system som körts under längre tid och därmed innehåller stora mängder loggar kan det vara en god idé att avsätta tid för den initiala loggraderingen och antingen minimera pausen mellan chunks (exempelvis DeleteLogsChunkSize=10000,0) eller radera samtliga loggposter i ett svep utan att dela upp dem i chunks (DeleteLogsChunkSize=max).
Minimera paus mellan chunks
Fördelen med att minimera pausen mellan chunks är att varje chunk hanteras som en separat transaktion. Om problem skulle uppstå med databasservern är det därmed enbart den senaste transaktionen (chunk) som behöver rullas tillbaka, och inte tidigare slutförda chunks. Detta resulterar i mindre förlorat arbete.
Nackdelen med att hantera loggposterna i chunks är att det tar längre tid, även med minimerad paus mellan chunks.
Radera samtliga loggposter i ett svep
Fördelen med att radera samtliga loggposter i ett svep är att det är den mest tidseffektiva lösningen, i och med att alla poster hanteras i en, oavbruten, transaktion.
Nackdelen med att radera samtliga loggposter i ett svep är att om problem skulle uppstå med databasservern måste hela transaktionen rullas tillbaka. Detta betyder att när raderingen återupptas så måste den börja om från början.
Funktionalitet med flera flexiteProcessEngine
I system där flera flexiteProcessEngine arbetar mot samma databas är det enbart en flexiteProcessEngine som sköter loggradering. Vilken flexiteProcessEngine det är beräknas med följande formel:
- Om E-posttjänsten (
MailSvc) är AKTIVERAD i systemet (flexiteCLIENT > Inställningar > Processmotor > Mail):- Den flexiteProcessEngine som är registrerad att hantera
MailSvchanterar loggradering.
- Den flexiteProcessEngine som är registrerad att hantera
- Om E-posttjänsten är INAKTIVERAD i systemet:
- Den flexiteProcessEngine som är registrerad att hantera OnHold-tjänsten (
OnHoldSvc) hanterar loggradering. Det är tekniskt möjligt att inaktivera ävenOnHoldSvc, men det är högst osannolikt i produktionssystem eftersom denna tjänst bland annat hanterar ärendeflöden.
- Den flexiteProcessEngine som är registrerad att hantera OnHold-tjänsten (
Loggning av radering
Loggar för radering av loggar skrivs löpande till databasen och sammanfattas en gång per dag i flexiteProcessEngines loggfil; flexiteProcessEngine.log.
Vid uppstart av flexiteProcessEngine skrivs aktuell konfiguration av loggradering till loggfilen. Förändringar av värdet för parametern DeleteLogsChunkSize loggas löpande till loggfilen.
Loggning av konfiguration vid uppstart
Vid uppstart av flexiteProcessEngine loggas aktuell konfiguration av DeleteLogsChunkSize. Om DeleteLogsChunkSize INTE är satt till disable följs detta av aktuell global konfiguration av radering av loggar.
Exempel med radering aktiverat globalt och i flexiteProcessEngine
I detta exempel är radering av loggar äldre än 366 dagar aktiverat för användarsessioner (User Sessions) samt ändringar i rättighetsgrupper (Authorization Group Changes).
log
2022-12-01 01:00:00 [dbServer:dbName] Initial log deletion chunk size: "10000,5"
2022-12-01 01:00:00 [dbServer:dbName] Deletion of logs for "User Sessions" enabled (Delete logs after 366 days)
2022-12-01 01:00:00 [dbServer:dbName] Deletion from log "Instance Search" disabled in flexiteCLIENT. See Settings > Logging and Automatic Erasure
2022-12-01 01:00:00 [dbServer:dbName] Deletion of logs for "Authorization Group Changes" enabled (Delete logs after 366 days)
2022-12-01 01:00:00 [dbServer:dbName] Deletion from log "Process Changes" disabled in flexiteCLIENT. See Settings > Logging and Automatic Erasure
2022-12-01 01:00:00 [dbServer:dbName] Deletion from log "Replace Data Task Changes" disabled in flexiteCLIENT. See Settings > Logging and Automatic Erasure
2022-12-01 01:00:00 [dbServer:dbName] Deletion from log "flexiteDB-link user import" disabled in flexiteCLIENT. See Settings > Logging and Automatic Erasure
2022-12-01 01:00:00 [dbServer:dbName] Deletion from log "User Account Changes" disabled in flexiteCLIENT. See Settings > Logging and Automatic Erasure
2022-12-01 01:00:00 [dbServer:dbName] Deletion from log "Manual Log Export" disabled in flexiteCLIENT. See Settings > Logging and Automatic ErasureExempel med radering inaktiverat i flexiteProcessEngine
I detta exempel är radering av loggar inaktiverat i aktuell flexiteProcessEngine genom att sätta DeleteLogsChunkSize till disable.
log
2022-12-01 01:00:00 [dbServer:dbName] Initial log deletion chunk size: "disable"Exempel med tjänsterna för e-post och OnHold inaktiverade i flexiteProcessEngine
I detta exempel är radering av loggar aktiverat samtidigt som tjänsterna för både e-post (MailSvc) och OnHold (OnHoldSvc) är aktiva i systemet men inaktiverade på aktuell flexiteProcessEngine.
log
2022-12-01 01:00:00 [dbServer:dbName] Initial log deletion chunk size: "10000,5"
2022-12-01 01:00:00 [dbServer:dbName] Log deletion cannot be started. Service MailSvc is not allowed to run on this host.Loggning vid förändring av DeleteLogsChunkSize
Vid förändring av konfiguration för DeleteLogsChunkSize loggas föregående och aktuellt värde. I detta exempel har DeleteLogsChunkSize ändrats från 10000,5 till disable. I och med att förändringen görs i en textfil på disk loggar inte flexite vem som utfört förändringen.
log
2022-12-01 01:00:00 [dbServer:dbName] Chunk size specification for log deletion changed from "10000,5" to "disable"Loggning för radering av loggar
Radering av loggar loggas löpande till databasen. I början av varje dygn skrivs en sammanställning av de loggar som raderats under föregående dygn till flexiteProcessEngines loggfil flexiteProcessEngine.log. Informationen som loggas är loggtyp, antal loggposter, antal chunks samt total tidsåtgång.
log
2023-04-01 00:30:45 [dbServer:dbName] During 2023-03-31 following deleting was done:
User Sessions: deleted 9600 records in 2 chunks; total time: 2,600 seconds.
Instance Search: deleted 8200 records in 3 chunks; total time: 8,800 seconds.
Authorization Group Changes: deleted 21000 records in 3 chunks; total time: 9,000 seconds.
Replace Data Task Changes: deleted 200 records in 1 chunks; total time: 10,500 seconds.
flexiteDB-link user import: deleted 6700 records in 1 chunks; total time: 7,100 seconds.
User Account Changes: deleted 3100 records in 1 chunks; total time: 5,300 seconds.
Manual Log Export: deleted 5000 records in 2 chunks; total time: 3,600 seconds.Export och lagringstid för loggar på disk
Loggar som lagras i databasen kan per loggtyp exporteras i klartext till disk. Det är även möjligt att ange hur många dagar som dessa exporterade loggar ska lagras. Konfiguration av export av loggar utförs i två steg, i flexiteCLIENT och i flexiteProcessEngine.
Aktivera export av loggar i flexiteCLIENT
Export av individuella loggar aktiveras globalt för systemet i flexiteCLIENT under Inställningar > Loggning och automatisk utplåning > Konfigurera loggning. Det är även här lagringstid för exporterade loggar anges.
- Exportera loggar till textfiler — Exportera loggar i klartext till fil belägen i en underkatalog till flexiteProcessEngine (som standard
AppLogs). De exporterade loggarna uppdateras varje minut. Varje natt tas det backup på dessa textfiler och lagras i samma katalog. - Radera textfiler efter ... dagar — Radera backup av exporterade textfiler som är äldre än angivet antal dagar.
Aktivera export av loggar i flexiteProcessEngine
Export av individuella loggar aktiveras och konfigureras per flexiteProcessEngine i konfigurationsfilen flexiteProcessEngine.ini.
Parametrar i flexiteProcessEngine.ini:
ini
[Database.0]
UsersSessionsLogs=AppLogs\UsersSessions
ExportUsersSessionsLog=1
AuthorizationChangesLogs=AppLogs\AuthorizationChanges
ExportAuthorizationChangesLog=1
SearchesLogs=AppLogs\Searches
ExportSearchesLog=1
InstancesLogs=AppLogs\Instances
ExportInstancesLog=1
ProcessChangesLogs=AppLogs\ProcessChanges
ExportProcessChangesLog=1
ReplaceDataTaskChangesLogs=AppLogs\ReplaceDataTaskChanges
ExportReplaceDataLog=1
ImportUsersLogs=AppLogs\ImportUsers
ExportImpUsersLog=1
UserAccountChangesLogs=AppLogs\UserAccountChanges
ExportUserAccountChanges=1
ManualExportLogs=AppLogs\ManualExport
ExportManualExport=1
Emails=AppLogs\Emails
ExportEmailsLog=1| Parameter | Beskrivning / Värde |
|---|---|
ExportUsersSessionsLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för användarsessioner till fil, i enlighet med konfiguration i flexiteCLIENT.
|
UsersSessionsLogs | Relativ sökväg för exporterade loggar för användarsessioner. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportAuthorizationChangesLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för ändringar i rättighetsgrupper till fil, i enlighet med konfiguration i flexiteCLIENT.
|
AuthorizationChangesLogs | Relativ sökväg för exporterade loggar för ändringar i rättighetsgrupper. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportSearchesLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för sökningar till fil, i enlighet med konfiguration i flexiteCLIENT.
|
SearchesLogs | Relativ sökväg för exporterade loggar för sökningar. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportInstancesLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för registreringar till fil, i enlighet med konfiguration i flexiteCLIENT.
|
InstancesLogs | Relativ sökväg för exporterade loggar för registreringar. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportProcessChangesLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för förändringar i process och organisation till fil, i enlighet med konfiguration i flexiteCLIENT.
|
ProcessChangesLogs | Relativ sökväg för exporterade loggar för förändringar i process och organisation. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportReplaceDataLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för gallring till fil, i enlighet med konfiguration i flexiteCLIENT.
|
ReplaceDataTaskChangesLogs | Relativ sökväg för exporterade loggar för gallring. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportImpUsersLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för flexiteDB-link användar- och objektimport till fil, i enlighet med konfiguration i flexiteCLIENT.
|
ImportUsersLogs | Relativ sökväg för exporterade loggar för flexiteDB-link användar- och objektimport. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportUserAccountChanges | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för förändringar av användarkonton till fil, i enlighet med konfiguration i flexiteCLIENT.
|
UserAccountChangesLogs | Relativ sökväg för exporterade loggar för förändringar av användarkonton. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportManualExport | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för manuell logg-export till fil, i enlighet med konfiguration i flexiteCLIENT.
|
ManualExportLogs | Relativ sökväg för exporterade loggar för manuell logg-export. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportEmailsLog | Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för e-postmeddelanden till fil, i enlighet med konfiguration i flexiteCLIENT.
|
Emails | Relativ sökväg för exporterade loggar för e-postmeddelanden. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |