Logging in Cloud-Native Deployments
Use, locations, and configuration options for logs produced by Tamr Core and its microservices and by cloud platform services.
Tamr Core Logs
Tamr Core saves logs in the <tamr_home_directory>/tamr/logs
directory of the Tamr Core installation. Tamr Core logs are created for each of the microservices and the log levels of each can be configured by setting configuration variables with the unify-admin utility, see Configuring Tamr Core. For example the log level for "unify", the microservice for the front-end user interface of Tamr Core, can be adjusted using TAMR_UNIFY_LOG_LEVEL
. By default, all log levels are set to INFO
.
Each microservice generates a <microservice>.log
file and a <microservice>.request.log
file. The <microservice>.log
files contain broad information about the microservice, while the <microservice>.request.log
tracks the API requests made to that microservice (including API requests generated by user actions in the UI).
Additional logs can also be generated depending on the microservice. If generated, the <microservice>.error.log
contains ERROR
level logs and <microservice>.out.log
contains the standard output.
DMS Logs
Data Movement Service logs can be found in the $TAMR_UNIFY_HOME/tamr/logs directory
with the format dms-*.log
.
Tip: The dms-all.out.log
file is a good starting point when reviewing logs.
To verify that the Data Movement Service has started successfully, after the service has started wait up to 30 seconds or check the logs for a message similar to this example:
INFO com.tamr.apps.distro.AppsService - Framework application ready
You can also submit a request to the /api/dms/service/health
API endpoint and look for a status of 200 to be returned.
Cloud Platform Service Logs
Cloud Platform | Service | References |
---|---|---|
AWS | Amazon EMR (Spark and Hbase) Amazon Elasticsearch Service (Elasticsearch) Amazon RDS (PostgreSQL) | AWS documentation Deploying Tamr Core on AWS |
GCP | Dataproc (Spark) Bigtable (Hbase) Cloud SQL (PostgreSQL) | GCP documentation Deploying Tamr Core on Google Cloud Platform |
See Also
Updated over 2 years ago