Skip to content

/openfaas-loki

Loki log provider for OpenFaaS
Go Makefile Smarty Dockerfile
  1. Go 79.0%
  2. Makefile 11.1%
  3. Smarty 5.7%
  4. Dockerfile 4.2%
Branch: master
Find File
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

@LucasRoesler
LucasRoesler Improve readme install instructions 
**What**
- Use `kubectl set env` to  make the install instructions more explicit

Signed-off-by: Lucas Roesler <roesler.lucas@gmail.com>
Latest commit ff62ac4 Jul 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Improve readme and remove boken ci step Jul 19, 2019
chart/openfaas-loki Update the helm chart notes to use kubectl Jul 23, 2019
cmd Add docker build Jul 17, 2019
pkg Parse instance label Jul 20, 2019
Dockerfile Add docker build Jul 17, 2019
LICENSE Add LICENSE Jul 19, 2019
Makefile Finish request parsing and tests Jul 19, 2019
README.md Improve readme install instructions Jul 23, 2019
go.mod Finish request parsing and tests Jul 19, 2019
go.sum Add server command Jul 16, 2019
main.go Improve readme and remove boken ci step Jul 19, 2019

README.md

OpenFaaS Loki

A Loki powered log provider for OpenFaaS

CircleCI Go Report Card Docker

OpenFaaS Loki implementes the new log provider interface from faas-provider. This means you can query Loki for your function logs with the faas-cli!

Limitations: This initial version does not support log tail streams. This means that faas-cli logs will alway behave as if --follow=false. Live tailing of the logs is currently being worked on.

All other OpenFaaS log behaviors should be fully supported. Issues are welcome if you notice a bug or room for improvement.

Install with Helm

  1. Clone this repo
  2. Determine the URL of your Loki installation, if you used the default Helm values to install Loki, this will be http://<service name>.<namespace>:3100
  3. Then install the openfaas-loki provider using Helm: 
    helm upgrade --install ofloki ./deployment/openfaas-loki \
    --namespace openfaas \
    --set lokiURL=http://loki.monitoring:3100 \
    --set logLevel=DEBUG
  4. Then update the gateway with the environment variable described in the NOTES output of the helm install. Currently, this can be done using 
    kubectl -n openfaas set env deployment/gateway -c gateway -e logs_provider_url=http://ofloki-openfaas-loki.openfaas:9191/
    The environment variable is only needed on the gateway container.
  5. Test the installation using 
    faas-cli store deploy nodeinfo
echo "" | faas-cli invoke nodeinfo
faas-cli logs nodeinfo --tail=3

Development flow

OpenFaaS Loki is built with go 1.12+ and uses go modules and all of the development actions are currently defined through the Makefile

Run tests

make test

Local install

You can install using

make install

Check the installation using

openfaas-loki --version

Docker Build

To enable more efficient builds, the Dockerfile uses the experimental RUN syntax to support build-time caches. This requires enabling the "experimental" features in your Docker installation. This will enable using buildkit as the build engine

Build the Docker image and verify the build using

make build
docker run theaxer/openfaas-loki:dev --version
You can’t perform that action at this time.