Humio

Instana supports integrating logs with Humio. After you enable the integration, you can be redirected to Humio UI from the Instana UI to view logs that are stored in Humio. This enables a fluid workflow between Instana and Humio.

Configuring Humio log management

You can configure Instana to integrate with logs that are stored in Humio. Follow the steps:

  1. Click Settings > Log management > Humio in the Instana UI.

    Humio Form

  2. By default, Humio log management is not enabled. To enable the Humio log integration, set the toggle to show Humio link on Hosts, Container and Pods.

    Humio Toggle

  3. Enter the following information:

    • In the Humio Instance field, enter the URL or the IP address (including the port number) of the deployed instance where the logs are stored.
    • In the View or repository field, enter the name of the view or repository you have configured in the Humio platform.

    Humio Toggle

    Humio Toggle

Accessing Humio from the Instana UI

To access Humio, click Humio, which is at the upper left of each of these dashboards:

  • Kubernetes:
    • Host
    • Pod
    • Docker container
  • Host

Humio Toggle

If multiple log providers are integrated, click Go to Logs > Humio.

Humio Buttons

Accessing Instana from Humio

Use either of the following options to enable accessing Instana-related entities from your logs:

  • Adjust your current search query:

    writeJson([host, @host, hostname, kubernetes.host, docker.container_id, kubernetes.docker_id, kubernetes.pod_name, @timestamp]) 
    |  format("https://<ENVIRONMENT_URL_HERE>/#/integration/landing;config=%s", field=_json, as=link) 
    |  table([@timestamp, @rawstring, link])
    
  • Create a new dashboard. Go to the Dashboards section in Humio. Click Add Dashboard, enter a name, select Template File, upload a file with the following content, and Create Dashboard.

    name: Humio to Instana
    widgets:
      eaea3c0e-7ca1-420c-a35a-150c67ea44f7:
        x: 0
        y: 0
        description: ''
        height: 10
        queryString: writeJson([host, @host, hostname, kubernetes.host, docker.container_id, kubernetes.docker_id, kubernetes.pod_name, @timestamp]) | format("https://<ENVIRONMENT_URL_HERE>/#/integration/landing;config=%s", field=_json, as=link) | table([@timestamp, @rawstring, link])
        visualization: table-view
        title: Instana
        type: query
        start: 24h
        width: 12
    parameters:
      new-param:
        defaultValue: '*'
        order: 50
        type: text