Skip to main content

Logging

The Logging console (/admin/logging/instance) provides centralized visibility into Turing ES operations. It is accessible from the sidebar and requires MongoDB to be enabled.

MongoDB required

The Logging console requires turing.mongodb.enabled: true. Logs are stored in MongoDB collections and automatically purged after the configured retention period. See Configuration Reference for setup details.


Log Categories

The logging landing page displays three cards, each linking to a dedicated log viewer:

CategoryPathDescription
Server/admin/logging/instance/serverGeneral application logs — startup, runtime errors, request processing, and framework messages
Indexing/admin/logging/instance/indexingContent indexing pipeline events — tracks every document from connector receipt through queue processing to final index commit
AEM/admin/logging/instance/aemAdobe Experience Manager connector logs — authentication, content retrieval, and AEM-specific processing

Server Logging

Displays general application logs captured from the Turing ES runtime.

Filters:

FilterDescription
LevelINFO, WARN, ERROR, DEBUG, TRACE — or All
Date From / Date ToRestrict results to a time window
SearchFree-text search across log messages and stack traces

Result columns:

ColumnDescription
DateFull timestamp with relative time (e.g., "2 hours ago")
NodeCluster node name (useful in multi-node deployments)
LevelColor-coded badge — blue (INFO), yellow (WARN), red (ERROR), purple (DEBUG), slate (TRACE)
LoggerJava class that produced the log entry
MessageLog message text with syntax highlighting

Stack trace viewer: Clicking the alert icon on an error row opens a resizable side panel (60/40 split) displaying the full stack trace with syntax highlighting for Java packages, severity levels, and Spring components.


Indexing Logging

Tracks every document through the indexing pipeline — from connector receipt to final index commit. This is the primary troubleshooting view for content indexing issues.

Filters:

FilterDescription
StatusAny of the indexing statuses listed below
Result StatusSUCCESS or ERROR
Date From / Date ToRestrict results to a time window
Content IDFilter by document ID (supports partial match)
URLFilter by document URL (supports partial match)

Result columns:

ColumnDescription
DateTimestamp with relative time
SourceSource system that sent the document
StatusProcessing status with icon and color coding (see table below)
Result StatusSUCCESS (green) or ERROR (red)
URLDocument URL (clickable)
EnvironmentAUTHOR (amber) or PUBLISHING (emerald)
LocaleLanguage code badge
SitesTarget SN Sites displayed as colored badges

Indexing Status Values

StatusIconDescription
PREPARE_INDEXSearchPreparing to index the document
PREPARE_UNCHANGEDClockNo changes detected since last indexing
PREPARE_REINDEXRefreshPreparing a reindexation
PREPARE_FORCED_REINDEXZapForced reindexation triggered
RECEIVED_AND_SENT_TO_TURINGSendDocument received by the connector and forwarded to Turing ES
SENT_TO_QUEUEArrowDocument placed in the Artemis processing queue
RECEIVED_FROM_QUEUEDatabaseDocument consumed from the queue by the indexing pipeline
INDEXEDCheckDocument successfully indexed
FINISHEDCheckOperation finished
DEINDEXEDBanDocument removed from the index
NOT_PROCESSEDClockDocument skipped
IGNOREDBanDocument ignored due to an indexing rule or connector decision

AEM Logging

Displays logs specific to the Adobe Experience Manager integration. The filter and column layout is identical to Server Logging — level, date range, and text search are available.

Use this view to diagnose AEM authentication failures, content retrieval errors, or replication issues.


Common Features

All three log viewers share the following capabilities.

Auto-Refresh

A dropdown in the page header configures automatic data refresh:

IntervalValue
OffNo auto-refresh
1 secondReal-time monitoring
5 secondsActive troubleshooting
10 secondsDefault monitoring
30 secondsBackground monitoring
1 minuteLow-frequency check
5 minutesPeriodic review

The last sync timestamp is displayed next to the refresh indicator.

Pagination

ControlDescription
Page navigationFirst, Previous, Next, Last page buttons
Rows per pageConfigurable: 10, 20, 30, 40, 50, or 100 rows
Sort orderAscending or descending by date

Syntax Highlighting

Log messages are rendered with syntax highlighting for:

  • Severity keywords — ERROR/FATAL (red), WARN (yellow), INFO (blue), DEBUG (purple)
  • Spring components — DispatcherServlet, ContextLoaderListener, Servlet, Filter (indigo)
  • Java packages and classes — amber italic
  • URLs and file paths — blue with underline
  • IP addresses — cyan
  • Quoted strings — sky blue monospace

REST API

The logging data is available via REST endpoints. Authentication required.

Server Logs

GET /api/logging
ParameterDefaultDescription
page0Page number
pageSize100Records per page
levelLog level filter (INFO, WARN, ERROR, DEBUG, TRACE)
dateFromStart date (yyyy-MM-dd)
dateToEnd date (yyyy-MM-dd)
searchText search in message or stack trace
sortascSort order (asc or desc)

Example:

curl "http://localhost:2700/api/logging?level=ERROR&pageSize=50&sort=desc" \
-H "Key: <YOUR_API_TOKEN>"

Indexing Logs

GET /api/logging/indexing
ParameterDefaultDescription
page0Page number
pageSize100Records per page
dateFromStart date (yyyy-MM-dd)
dateToEnd date (yyyy-MM-dd)
statusIndexing status filter (see status table above)
contentIdContent ID filter (partial match)
resultStatusSUCCESS or ERROR
urlURL filter (partial match)
sortascSort order (asc or desc)

Example:

curl "http://localhost:2700/api/logging/indexing?status=INDEXED&resultStatus=ERROR&sort=desc" \
-H "Key: <YOUR_API_TOKEN>"

AEM Logs

GET /api/logging/aem

Same parameters as Server Logs.

Response Structure

All three endpoints return a paginated response:

{
"content": [ ... ],
"page": 0,
"pageSize": 100,
"totalElements": 1250,
"totalPages": 13
}

Configuration

Logging is configured in application.yaml. See Configuration Reference for the full property list.

MongoDB (application logs):

turing:
mongodb:
enabled: true
uri: mongodb://localhost:27017
logging:
database: turingLog
collection:
server: server
aem: aem
indexing: indexing
purge:
days: 30

Local file logging (Logback):

logging:
file:
name: store/logs/turing.log
logback:
rollingpolicy:
max-file-size: 25MB
max-history: 10
level:
com.viglet: INFO
org.springframework: INFO
dev.langchain4j: INFO

PageDescription
Configuration ReferenceFull property reference for MongoDB and Logback settings
IntegrationIntegration monitoring dashboard (per-connector indexing events)
Architecture OverviewEnd-to-end indexing flow