​
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)
  • 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:

​
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.