​

Overview

Grafana Loki is a log aggregation system designed to store and query logs from all your applications and infrastructure. The easiest way to get started is with Grafana Cloud, our fully composable observability stack.

​

Authentication

This provider requires authentication.

• host_url: Grafana Loki Host URL (required: True, sensitive: False)
• verify: Enable SSL verification (required: False, sensitive: False)
• authentication_type: Authentication Type (required: True, sensitive: False)
• username: HTTP basic authentication - Username (required: False, sensitive: False)
• password: HTTP basic authentication - Password (required: False, sensitive: True)
• x_scope_orgid: X-Scope-OrgID Header Authentication (required: False, sensitive: False)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

• authenticated: Instance is valid and user is authenticated

​

In workflows

This provider can be used in workflows.

As “step” to query data, example:

steps:
    - name: Query grafana_loki
      provider: grafana_loki
      config: "{{ provider.my_provider_name }}"
      with:
        query: {value}
        limit: {value}
        time: {value}
        direction: {value}
        start: {value}
        end: {value}
        since: {value}
        step: {value}
        interval: {value}
        queryType: {value}

Check the following workflow example:

• query_grafana_loki.yaml

​

Connecting with the Grafana Loki provider

1. Obtain the required authentication parameters.
2. Add Grafana Loki provider to your keep account and configure with the above authentication parameters.

​

Querying Grafana Loki

The Grafana Loki provider allows you to query logs from Grafana Loki through the query and query_range types. The following are the parameters available for querying:

1. query type:

   • query: The LogQL query to perform. Requests that do not use valid LogQL syntax will return errors.
   • limit: The max number of entries to return. It defaults to 100. Only applies to query types which produce a stream (log lines) response.
   • time: The evaluation time for the query as a nanosecond Unix epoch or another supported format. Defaults to now.
   • direction: Determines the sort order of logs. Supported values are forward or backward. Defaults to backward.

2. query_range type:

   • query: The LogQL query to perform.
   • limit: The max number of entries to return. It defaults to 100. Only applies to query types which produce a stream (log lines) response.
   • start: The start time for the query as a nanosecond Unix epoch or another supported format. Defaults to one hour ago. Loki returns results with timestamp greater or equal to this value.
   • end: The end time for the query as a nanosecond Unix epoch or another supported format. Defaults to now. Loki returns results with timestamp lower than this value.
   • since: A duration used to calculate start relative to end. If end is in the future, start is calculated as this duration before now. Any value specified for start supersedes this parameter.
   • step: Query resolution step width in duration format or float number of seconds. duration refers to Prometheus duration strings of the form [0-9]+[smhdwy]. For example, 5m refers to a duration of 5 minutes. Defaults to a dynamic value based on start and end. Only applies to query types which produce a matrix response.
   • interval: Only return entries at (or greater than) the specified interval, can be a duration format or float number of seconds. Only applies to queries which produce a stream response. Not to be confused with step, see the explanation under Step versus interval.
   • direction: Determines the sort order of logs. Supported values are forward or backward. Defaults to backward.

​

Useful Links

• Grafana Loki
• Grafana Loki Authentication