Previous

Next

Exercise - sample application environment

Completed

In this exercise, you'll configure a sample Application to be ready for monitoring. Later, you'll access the collected monitoring data and view it in the Azure portal.

Introduction

In this exercise, you'll clone a Git repository and run a script that sets-up an Azure Spring Apps application and Azure Database for MySQL. The script deploys a well-known PetClinic microservice application and is built around small independent services, communicating over HTTP via a REST API.

The sample microservice application

The PetClinic application is decomposed into four core microservices. All of them are independently deployable applications organized by business domains.

• Customers service: Contains general user input logic and validation including pets and owners information (Name, Address, City, Telephone).
• Visits service: Stores and shows visits information for each pets' comments.
• Vets service: Stores and shows Veterinarians' information, including names and specialties.
• API Gateway: A single entry point into the system, used to handle requests and route them to an appropriate service, and aggregate the results.

Set up the sample microservice application

In a web browser, open https://shell.azure.com in a new browser window. Select "Bash" mode in the top right-hand side. Next, in the bash window, run the following commands to clone the sample repository and open the built-in Azure editor:

git clone https://github.com/MicrosoftDocs/mslearn-monitoring-java
cd mslearn-monitoring-java
code deployPetClinicApp.sh

Set up and run the Setup script

When you run the above command, a window will pop up with the file deployPetClinicApp.sh ready to be edited in the built-in Azure editor.

1. At the top of the deployPetClinicApp.sh file, edit the following variables to customize the scripts parameters for your environment. For all resource names please use lowercase letters - you may use hyphens and numbers also:

   Variable	Description
   resource_group	Provide a new or existing resource group name
   region	The Azure region you'll use. You can use westeurope by default, but we recommend that you use a region close to where you live and that also support Azure Spring Apps. To see the full list of available regions, visit the Azure Spring Apps Availability by Region in the Summary unit at the end of this module
   spring_apps_service	Name of your Azure Spring Apps instance
   mysql_server_name	The name of your MySQL server. It should be unique across Azure
   mysql_server_admin_name	Username for the MySQL Administrator. The admin name can't be "azure-superuser", "admin", "administrator", "root", "guest, or "public"
   mysql_server_admin_password	A new password for the server admin user. The password must be 8 to 128 characters long and contain a combination of uppercase or lowercase letters, numbers, and non-alphanumeric characters (!, $, #, %, and so on).
   log_analytics	Name of your Azure Log Analytics workspace

2. Save the file by selecting the ... action panel in the top right of the editor and select "Save".

3. Close the editor - open the ... action panel in the top right of the editor and select "Close Editor".

4. Don't close the Azure Cloud Shell, as next, we'll run the setup script.

Run the setup script

The script takes 30-45 minutes to run and includes the creation of an Azure spring Apps and a MySQL instance. This sample script also populates sample data for the monitoring logs, traces, and metrics.

In the already open Azure Cloud Shell, run the below shell script. Leave the browser window and Azure Cloud Shell open while running. Store the URL when the script completes:

bash deployPetClinicApp.sh

Important

If you run into errors with the setup script, the script will attempt to delete any resources it creates. You can then try again once the resource group is fully deleted. The Summary unit has instructions on how do also delete your resources manually.

Test the application

Next, we'll verify your environment via the Azure portal.

1. Open the Azure portal

2. Select "Azure Spring Apps" from the list of Azure services

3. Select your Azure Spring Apps instance

4. On the right-hand side, select "Apps" under settings

5. Verify all the applications are running and registered

   

6. On the left-hand side, select the "api-gateway" application

7. The URL for your application is listed on the left-hand side properties as "URL"

   

In a web browser, navigate to the URL of your api-gateway to open the Pet Clinic microservice application.

Next, navigate to the "Owners" tab and select "Find all owners". Confirm your sample application is up and running, populated with data and now ready for you to explore.

Continue