Skip to content

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 ​

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ärdeBeskrivning

{chunkSize},{timeBetweenChunks}

Exempel: DeleteLogsChunkSize=10000,5

  • {chunkSize} — Antal loggposter som ska raderas i en och samma chunk. I varje chunk hanteras enbart loggposter från en och samma databastabell.
  • {timeBetweenChunks} — Tid i sekunder mellan radering av chunks. Under denna tid kan andra operationer startas och skriva till de tabeller i databasen som annars låses av loggraderingen.
    Värdet 0 innebär att loggposterna raderas i chunks, men att pausen mellan chunks är minimal. 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.

Standardvärde: 10000,5

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 MailSvc hanterar loggradering.
  • 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 även OnHoldSvc, men det är högst osannolikt i produktionssystem eftersom denna tjänst bland annat hanterar ärendeflöden.

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 Erasure
Exempel 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
ParameterBeskrivning / Värde

ExportUsersSessionsLog

Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för användarsessioner till fil, i enlighet med konfiguration i flexiteCLIENT.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\UsersSessions

ExportAuthorizationChangesLog

Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för ändringar i rättighetsgrupper till fil, i enlighet med konfiguration i flexiteCLIENT.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\AuthorizationChanges

ExportSearchesLog

Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för sökningar till fil, i enlighet med konfiguration i flexiteCLIENT.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\Searches

ExportInstancesLog

Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för registreringar till fil, i enlighet med konfiguration i flexiteCLIENT.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\Instances

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.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\ProcessChanges

ExportReplaceDataLog

Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för gallring till fil, i enlighet med konfiguration i flexiteCLIENT.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\ReplaceDataTaskChanges

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.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\ImportUsers

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.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\UserAccountChanges

ExportManualExport

Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för manuell logg-export till fil, i enlighet med konfiguration i flexiteCLIENT.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\ManualExport

ExportEmailsLog

Anger om aktuell flexiteProcessEngine ska kunna exportera loggar för e-postmeddelanden till fil, i enlighet med konfiguration i flexiteCLIENT.

  • 0 — Inaktivera export. (standard om värde saknas)
  • 1 — Aktivera export.

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: AppLogs\Emails