loki2slack

loki2slack

A Loki to Slack message forwarder.

Badges

Quick Start

cd platform/dev
docker-compose --project-name example_logging up -d
docker-compose --project-name example_logging logs -f

Now is a separate terminal

./platform/dev/loki_post.sh

Slack App

To post to Slack, configure the platform/dev/loki2slack.cfg with SlackToken and SlackChannelId, restart loki2slack container.

Configure Local Grafana with loki as a data source named Loki.

Notes:

• The slack token must have channels:join,chat:write,files:write scopes.
• For links in the eventual slack message to open in the correct place the data source name must match in the loki2slack.cfg file.

A minimum Slack App manifest needed by this app is;

_metadata:
  major_version: 1
  minor_version: 1
display_information:
  name: APPNAME
features:
  bot_user:
    display_name: DIPLAYNAME
    always_online: false
oauth_config:
  scopes:
    bot:
      - chat:write
      - files:write
      - channels:join
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

Experimenting with Slack

see docs/slack_posts.md

Build

Using Multipart Docker File

docker build --file Dockerfile.multipart --tag ghcr.io/helix-collective:latest .

Docker Image Using goreleaser

goreleaser --skip-publish --skip-validate --rm-dist

Local Development

Simply do a local go build, when running loki2slack use --addr localhost:9096 or in the loki2slack.cfg set the Addr to localhost:9096.

Release

CI

Push a tag.

Locally Using goreleaser

Export a GITHUB_TOKEN as an env var.

# must be a personal access token with package write permission
echo $GITHUB_TOKEN | docker login ghcr.io -u $GITHUB_USER --password-stdin
goreleaser

Deploy

Note ensure Loki is configure for grpc. IE

server:
  http_listen_port: 3100
  grpc_listen_port: 9096
...

Entries in the loki2slack.cfg file much match your deployment setup.

Note: it might be easier to run multiple contains each with simple queries than construct one large query.