Challenge 00 - Prerequisites - Ready, Set, GO! (Lab Provided)

< Previous Challenge - Home - Next Challenge >

Introduction

Thank you for participating in the New Relic Agent Observability What The Hack. An Azure lab environment will be provided to you with the AI and New Relic resources pre-deployed into Azure. Before you can hack, you will still need to set up some prerequisites.

Prerequisites

We have compiled a list of common tools and software that will come in handy to complete this hack!

Description

In this challenge, you will set up the necessary prerequisites and environment to complete the rest of the hack.

Access Azure Subscription

You will be provided login credentials to an Azure subscription to complete this hack by your coach. When you receive your credentials, make note of them and login to the Azure Portal:

Keep your credentials handy as you will also need them to login to the Azure CLI (command line interface).

Setup Development Environment

You will need a set of developer tools to work with the sample application for this hack.

You can use GitHub Codespaces where we have a pre-configured development environment set up and ready to go for you, or you can set up the developer tools on your local workstation.

NOTE: We highly recommend using GitHub Codespaces to make it easier to complete this hack.

Use GitHub Codespaces

A GitHub Codespace is a development environment that is hosted in the cloud that you access via a browser. All of the prerequisite developer tools for this hack are pre-installed and available in the codespace.

GitHub Codespaces is available for developers in every organization. All personal GitHub.com accounts include a monthly quota of free usage each month. GitHub will provide users in the Free plan 120 core hours, or 60 hours of run time on a 2 core codespace, plus 15 GB of storage each month. You can see your balance of available codespace hours on the GitHub billing page.

The GitHub Codespace for this hack will host the developer tools, sample application code, configuration files, and other data files needed for this hack.

NOTE: Make sure you do not sign in with your enterprise managed GitHub account.

NOTE: If you close your Codespace window, or need to return to it later, you can go to GitHub Codespaces and you should find your existing Codespaces listed with a link to re-launch it.

NOTE: GitHub Codespaces time out after 20 minutes if you are not actively interacting with it in the browser. If your codespace times out, you can restart it and the developer environment and its files will return with its state intact within seconds. You can also update the default timeout value in your personal setting page on GitHub. Refer to this page for instructions: Default Timeout Period

NOTE: Codespaces expire after 30 days unless you extend the expiration date. When a Codespace expires, the state of all files in it will be lost.

Use Local Workstation

NOTE: You can skip this section if you are using GitHub Codespaces!

If you want to set up your environment on your local workstation, expand the section below and follow the requirements listed.

Click to expand/collapse Local Workstation Requirements
Download Student Resources

Download the Student Resources package, Resources.zip to your local workstation. Un-zip this package to a local folder, then follow the instructions below to open the DevContainer in VS Code.

Set Up Local Dev Container

You will next be setting up your local workstation so that it can use dev containers. A Dev Container is a Docker-based environment designed to provide a consistent and reproducible development setup. The VS Code Dev Containers extension lets you easily open projects inside a containerized environment.

NOTE: On Windows, Dev Containers run in the Windows Subsystem for Linux (WSL).

On Windows and macOS (NOTE: only tested on Apple Silicon):

  • Download and install Docker Desktop
  • (macOS only) In Docker Desktop settings, choose Apple Virtualization Framework for the Virtual Machine Manager. Also, click the checkbox to use Rosetta for x86_64/amd64 emulation on Apple Silicon
  • (Windows only) Install the Windows Subsystem for Linux along with a Linux distribution such as Ubuntu
  • Open the root folder of the Student resource package in Visual Studio Code
  • You should get prompted to re-open the folder in a Dev Container. You can do that by clicking the Yes button, but if you miss it or hit no, you can also use the Command Palette in VS Code and select Dev Containers: Reopen in Container

Gather Your Credentials

Before proceeding with the hack, you will need to gather the following credentials from your provided environment:

Microsoft Foundry Credentials

  1. Navigate to your Microsoft Foundry environment
  2. Locate and copy your Foundry Endpoint URL
  3. Locate and copy your Foundry API Key

Keep these credentials in a safe place as you will need them to configure your application in the upcoming challenges.

New Relic License Key

  1. Access your New Relic account at https://one.newrelic.com/
  2. Navigate to your account settings or API keys section at https://one.newrelic.com/launcher/api-keys-ui.api-keys-launcher
  3. Locate and copy your New Relic License Key (also known as Ingest License Key)

This license key will be used to send telemetry data from your application to New Relic for observability and monitoring.

Success Criteria

To complete this challenge successfully, you should be able to:

Learning Resources