Shipmight Logo

Configuring Loki

Shipmight integrates with Grafana Loki for:

  • browsing container logs in Shipmight UI

Grafana Loki and Promtail are included as optional dependencies of the Shipmight stack.

How it works

Promtail collects logs from containers in the cluster and sends them to Loki, which stores them (by default in an infinitely scalable S3 bucket).

Shipmight API fetches filtered logs from the Loki HTTP API for the user to view.

When the Loki-integration is disabled, features related to viewing logs are hidden in the project view, and disabled in Manage. For a description of these features, see Logs.

Enabling Loki

The following will install Loki and Promtail, and configure Shipmight to query the Loki API:

helm upgrade shipmight shipmight/shipmight-stack \
  --set loki.enabled=true \
  --set<access-key>:<secret-access-key>@<s3-endpoint>/<bucket-name> \
  --set promtail.enabled=true \
  --set shipmight.config.lokiEndpoint=http://shipmight-loki:3100

Configuring Loki datastore

You can configure Loki storage via loki.config.storage_config:

helm upgrade shipmight shipmight/shipmight-stack \
  # A) S3 bucket
  # B) S3 via individual components
  --set<s3-endpoint> \
  --set<bucket-name> \
  --set<access-key> \
  # C) In-memory S3 bucket for testing purposes only (do NOT use in production)

Refer to these links for more information on available storage configurations:

Disabling Loki

The following will uninstall Loki and Promtail, and disable the integration in Shipmight:

helm upgrade shipmight shipmight/shipmight-stack \
  --set loki.enabled=false \
  --set promtail.enabled=false \
  --set shipmight.config.lokiEndpoint=null






Join the mailing list to get notified when a new version or new content on the website is released. Max 1 email per week.

Don’t reinvent the shipCopyright © Fine Productions Oy/Ltd