Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tersesystems/play-blindsight

Example "observability" project using Play with Blindsight and Honeycomb
https://github.com/tersesystems/play-blindsight

blindsight honeycomb logging playframework scala structured-logging tracing

Last synced: 16 days ago
JSON representation

Example "observability" project using Play with Blindsight and Honeycomb

Awesome Lists containing this project

README

        

# Play-Blindsight

This is an example Play project that shows how to integrate [Play](https://www.playframework.com/) with [Honeycomb Tracing](https://docs.honeycomb.io/working-with-your-data/tracing/explore-trace-data/) using the [flow logger](https://tersesystems.github.io/blindsight/usage/flow.html) from [Blindsight](https://tersesystems.github.io/blindsight/).

## Requirements

You will need a Honeycomb account, which is free:

https://ui.honeycomb.io/signup

Create a dataset called `blindsight-test`.

Once you have the account, you'll need to set the environment variables.

```bash
export HONEYCOMB_API_KEY=
export HONEYCOMB_DATASET=blindsight-test
```

These correspond to the honeycomb appender in `conf/logback.xml`

```xml

${HONEYCOMB_API_KEY}
${HONEYCOMB_DATASET}


```

## Running

Assuming you have sbt and java installed:

```
sbt run
```

And go to http://localhost:9000.

You will see the page render.

Now go to the `blindsight-test` dataset in Honeycomb, and click on the trace that you see down at the bottom. You should see:

![Trace From Play](trace.png)

## How It Works

[Magic](https://tersesystems.github.io/blindsight/usage/flow.html#integrating-with-tracing).