Logging for Schematics

Schematics generate platform logs that you can use to investigate abnormal activity and critical actions in your account, and troubleshoot problems.

You can use IBM Cloud Logs Routing, a platform service to route platform logs in your account to a destination of your choice by configuring a tenant that defines where platform logs are sent. For more information, see About Logs Routing.

You can use IBM Cloud Logs to visualize and alert on platform logs that are generated in your account and routed by IBM Cloud Logs Routing to an IBM Cloud Logs instance.

As of 28 March 2024, the IBM Log Analysis service is deprecated and will no longer be supported as of 30 March 2025. Customers will need to migrate to IBM Cloud Logs before 30 March 2025. During the migration period, customers can use IBM Log Analysis along with IBM Cloud Logs. Logging is the same for both services. For information about migrating from IBM Log Analysis to IBM Cloud Logs and running the services in parallel, see migration planning.

Locations where platform logs are generated

Locations where logs are sent to IBM Log Analysis

Schematics sends platform logs to IBM Log Analysis in the regions indicated in the following table.

Regions where platform logs are sent in Americas locations
Dallas (`us-south`)	Washington (`us-east`)
Yes	Yes

Regions where platform logs are sent in Europe locations
Frankfurt (`eu-de`)	London (`eu-gb`)
Yes	Yes

Locations where logs are sent by IBM Cloud Logs Routing

Schematics sends logs by IBM Cloud Logs Routing in the regions that are indicated in the following table.

Regions where platform logs are sent in Americas locations
Dallas (`us-south`)	Washington (`us-east`)
Yes	Yes

Regions where platform logs are sent in Europe locations
Frankfurt (`eu-de`)	London (`eu-gb`)
Yes	Yes

Platform logs that are generated

Schematics fully manage enterprise-grade IBM Cloud® Log Analysis that can store, search, analyze, monitor, and alert on your IBM Cloud logging data and events. This feature includes live logs, custom views, and alert of the Schematics workspaces by connecting, configuring, and viewing through observability dashboards.

Launching IBM Cloud Logs from the Observability page

For more information about launching the IBM Cloud Logs UI, see Launching the UI in the IBM Cloud Logs documentation.

Fields by log type

For information about fields included in every platform log, see Fields for platform logs. The Schematics follows the guidelines for log types and log records.

Log record fields
Field	Type	Description
`logSourceCRN`	`Required`	Defines the account and flow log instance where the log is published.
`saveServiceCopy`	`Required`	Defines whether IBM saves a copy of the record for operational purposes.
`message`	`Required`	Description of the log that is generated.
`messageID`	`Required`	ID of the log that is generated.
`msg_timestamp`	`Required`	The timestamps when the log is generated.
`resolution`	`Optional`	Guidance on how to proceed if you receive this log record.
`documentsURL`	`Optional`	More information on how to proceed if you receive this log record.