Skip to content

Logging#

Logging Dashboard#

See Getting Around page for information about how to access the logging dashboard.

All users with an account to access the amazee.io Lagoon dashboard, will be able to access the logging dashboard. Which logs a user can see and which tenants you have access to will depend on which groups a user account is associated to in Lagoon.

A Lagoon group will have an associated tenant in the logging dashboard which can be used to view logs for projects associated to that group. Only users of that group will have access to the tenant, so this is a convenient place to store your custom visualisations, saved searches and dashboards.

Log retention#

Amazee.io will by default store logs for:

  • The current calendar month (open 🟢)
  • The last calendar month for router logs (open 🟢 until roughly the 10th of the month, then they will be closed 🟡)
  • The last calendar month for application, lagoon and container logs (closed 🟡)

Closed 🟡 indices can be re-opened with a support ticket. Only open 🟢 indices can be searched.

Logs older than 2 months are deleted 🔴 to ensure the cluster stays healthy.

Dedicated Cloud customers are able to have their logs shipped to other locations of their choosing. Please reach out to support if you want to know more.

Real time container logs via Lagoon CLI#

It is possible to view a live stream of container logs for a Lagoon service using the Lagoon CLI logs command. Check the linked command documentation for additional flags that it may support.

This command will show you container logs for the specified service from the currently running pods in the cluster, and the --follow flag will stream logs in real time. This feature is useful for diagnosing an issue without having to access the logging dashboard.

Example logs command
lagoon logs --project my-project --environment main --service nginx [--follow]

Note

There are limitations on how long you can follow logs for, and how much log history is accessible with this feature.

Further Reading#

More information to come, see Logging Examples and Lagoon Logging documentation