Honeycomb Academy: Sample Meminator App

This is a demo app, don't run it in production.

This contains a sample application for use in Honeycomb Academy lab activities. This app has 4 services.

It generates images by combining a randomly chosen picture with a randomly chosen phrase.

Introduction

Hello! Welcome to the Instrumenting with Node.js course lab.

1. Take a look at this app. The backend-for-frontend service needs to be instrumented.
2. Before you can do that, you need to run this app.
3. Then, connect this app to Honeycomb.
4. See what the traces look like.
5. Improve the traces.

Running the application

To run this app, you can use Codespaces. Note that Codespades is free up to a certain number of hours per month.

Once you run the application, you can send traces to Honeycomb. Then you can practice improving the instrumentation for better observability.

GitHub Codespaces setup

Open the repository on GitHub. Open the <> Code dropdown down menu.

Select the Codespaces tab. Create a codespace on main.

One-time setup

You also have the option to run this application locally.

First, clone this repository.

git clone https://github.com/honeycombio/academy-instrumentation-nodejs

Install Docker: https://docs.docker.com/get-docker/

Run the app

./run

(This will run docker compose in daemon mode, and build containers.)

Access the app:

http://localhost:10114

After making changes to a service, you can tell it to rebuild just that one:

./run [ meminator | backend-for-frontend | image-picker | phrase-picker ]

Try it out

Visit http://localhost:10114

Click the "GO" button. Then wait.

Stop the app

./stop