Intro to o11y Topic 2: Get Your Honeycomb Team
The first step to observability is to copy an application and link it to your Honeycomb account. To link them, we’ll need an API key from Honeycomb. Developer Advocate Jessica Kerr walks you through that process here.
Depending on your starting point, follow one of these:
Jessica Kerr [Developer Advocate|Honeycomb]:
I Need a Honeycomb Account:
I start at Honeycomb.io, and click on Get Started in the upper right. I could sign up with Google. Today, I’ll enter my name and email, and click again to continue.
It wants to send a confirmation link. Okay, so I find that link in my email, and click it or paste it into my browser.
Now it’s time to enter a nice secure password which I have generated and saved in my password manager.
Okay, I’m in. What is this screen? Well, Honeycomb is all about teams, so I need to create one. I’ll give it a name and push “Create Team” and now I’m ready to send data to Honeycomb. Here is the API key I need. I copy it with this copy button.
I have a Honeycomb account
In this video, we will create a new team and get its API key. I start by logging in to Honeycomb. From there, I click on the bee icon in the bottom left.
From the popup menu, pick “My account.” Now on the left, it’s time to choose “your teams” Below the teams you already have is “Create team.” Here’s a new name, I put it in the box.
Click create. Next, I need to create an environment. An environment in Honeycomb is a grouping of data that doesn’t relate to each other. Your production data should be separate from your development environment or your test environment.
Let’s name ours “test.” Enter it here and click continue.
Okay, I’m back here. Am I working in the new team now? I’d better click on my account name or picture again. This tells me my current team. Oh no, that’s the old team still. Okay. Choose “switch teams” and pick the new team.
Hmm, the page looks the same. Am I on the right team now? Let’s check. Click on my account again. Ah-ha, this looks right! I’m in the new team. Here is the API key I need. I copy it.
I am ready with a Honeycomb account and team
Given that I’m logged in to Honeycomb and in the team I want to use, here are a few ways I can get an API key. If I haven’t sent data to this team before, then when I click the Honeycomb logo in the upper left, then the home screen is dying to give me my API key, it wants the data so much.
Or, I can always go to the team settings by clicking on account in the bottom left and choosing Team Settings. Here, under environments and API keys, I click Manage. Here’s one API key. I could copy it and use it. Or, I can create a new one, and give it a name that tells future me where it’s about to be used.
I need my API key to have “Send Events” and “Create Dataset” permissions. These others I can uncheck if I want to. Save that, and then click this button to copy the new API key. I am ready to go.
Intro to o11y Topic 1: What Is Observability?
In this video, Jessica clears up some important terminology on observability.
Intro to o11y Topic 3: Get Your Own Sample App
The Intro to o11y video tutorial series will use a sample app called Sequence of Numbers to demonstrate Honeycomb’s functionality. In this video, Developer Advocate Jessica Kerr covers how to get that app up and running yourself.