Log Files¶
Every log file MetaMiner writes, which process writes it, where it is, and how long it is kept.
Paths below are relative to the installation folder, for example C:\Program Files\Infolytik\MetaMiner\. To send
logs to Infolytik, create a log bundle instead of copying files by hand. For
how to read them, see Log Files and Diagnostics.
Image of the MMA File menu with Open MetaMiner Service Log, Open Log Folder, Purge Logs and Create Log Bundle
../../images/help/mma-file-menu-logs.png
MetaMiner Server (service metaminer)¶
Folder: server\logs\. Rotated files are compressed to <name>-<date>-<n>.log.zip or <name>.<n>.log.zip.
| File | Content | Rotation and retention |
|---|---|---|
server.start.log |
Launcher output: Java options, property values and errors before logging starts | Written by the service launcher, not by MetaMiner's log settings |
server.log |
Main log: pulls, processing, errors of all components | Daily and at 10 MB, kept 14 days |
slc.log |
Service lifecycle: start, ready, reload and stop events | Daily and at 10 MB, kept 14 days |
clients-activity.log |
MetaMiner Client connections and sign-in attempts | Daily and at 10 MB, kept 90 days |
mmdb.log |
MetaMiner Database messages and schema updates | Daily and at 5 MB, kept 10 days |
postgres.log |
Embedded PostgreSQL start and stop as seen by the MMS | Daily and at 2 MB, kept 3 days |
query.log |
BusinessObjects repository queries run during pulls | Daily and at 10 MB, kept 14 days |
longquery.log |
MetaMiner Database queries that ran longer than expected | 5 MB per file, 10 files |
universe-errors.log |
Universe processing errors | Daily and at 10 MB, kept 30 days |
diagnostic.log |
Diagnostic and notification activity | 5 MB per file, 10 files |
threads.log |
Thread dumps written when an action takes too long, or on request | 5 MB per file, 10 files |
statereport.log |
Periodic summaries of the state of each engine | Daily and at 25 MB, kept 14 days |
influx.log, grafana.log |
Pulse metrics store and dashboards, when enabled | Daily and at 2 MB, kept 3 days |
gc-<timestamp>.log |
Java garbage collection | 10 MB per file, 40 files |
restarter.log |
Service restarter helper, when used | 5 MB per file, 10 files |
boconnectivity.log |
Universe conversion helper, when used | 5 MB per file, 5 files |
Other diagnostic output of the server:
| Location | Content |
|---|---|
server\java_pid<nnnn>.hprof |
Heap dump written on an out-of-memory error. As large as the heap |
server\health\incidents-<date>.jsonl |
Summary of detected problems, used by the MMA health indicator. Kept 90 days |
server\data\mmdb\logs\ |
PostgreSQL's own logs for the embedded MetaMiner Database |
MetaMiner Administrator¶
Folder: server\logs\ (the MMA runs on the server).
| File | Content | Rotation and retention |
|---|---|---|
admin.log |
MMA activity, environment validation, saves | 5 MB per file, 10 files |
admin.start.log |
MMA launcher output | Written by the launcher |
mma-audit.log |
Record of configuration changes made in the MMA | Daily and at 10 MB, kept 90 days |
MetaMiner Web Apps (service MetaMinerWebApps)¶
Folder: server\logs\.
| File | Content | Rotation and retention |
|---|---|---|
webapps.log |
Web Console and dashboard requests and errors | Daily and at 50 MB, kept 30 days |
webapps.queries.log |
Database queries run by the web apps | Daily and at 50 MB, kept 30 days |
webapps.start.log |
Launcher output | Written by the launcher |
MetaQuery agent¶
Folder: server\logs\.
| File | Content | Rotation and retention |
|---|---|---|
queryagent.log |
Meta Query agent activity | 5 MB per file, 10 files |
queryagentquery.log |
Queries run by Meta Query | 5 MB per file, 10 files |
queryagentlongquery.log |
Meta Query queries that ran long | 5 MB per file, 10 files |
queryagent.start.log |
Launcher output | Written by the launcher |
MetaMiner Client¶
Folder: %APPDATA%\MetaMiner\logs\ for each Windows user. Open it from the MMC with File > Open MetaMiner Log
Folder.
| File | Content | Rotation and retention |
|---|---|---|
client.log |
MMC activity and errors | 5 MB per file, 5 files (client.<n>.log.zip) |
client.start.log |
Launcher output | Written by the launcher |
Managing log files¶
- The MMA File menu opens the most-used logs (Open MetaMiner Administrator Log, Open MetaMiner Service Log, Open Diagnostic Log, Open Threads Log) and the folder (Open Log Folder).
- File > Purge Logs deletes the contents of
server\logs\. Create a log bundle first if you may need support. - File > Analyze Logs... scans a logs folder and opens a summary report in your browser. See Analyze Logs.