📝 Best Practice from the Smart Home Industry: Migration from Docker Swarm to Kubernetes. Explore this journey → close
  • English
    • English
    • 简体中文
    1. 1.Experience account: demo1 / Demo123
    2. 2.This account is only allowed to view parts of UI
    3. 3.It's recommended that install KubeSphere in your environment

You are viewing documentation for KubeSphere version:v3.0.0

KubeSphere v3.0.0 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

  1. Documentation / 
  2. Project User Guide / 
  3. Custom Application Monitoring / 
  4. Examples / 
  5. Monitor a Sample Web Application

Project User Guide

Last updated:
    Edit

    Monitor a Sample Web Application

    This section walks you through monitoring a sample web application. The application is instrumented with Prometheus Go client in its code. Therefore, it can expose metrics directly without the help of exporters.

    Prerequisites

    • Please make sure you enable the OpenPitrix system.

    • You need to create a workspace, a project, and a user account for this tutorial. For more information, see Create Workspaces, Projects, Accounts and Roles. The account needs to be a platform regular user and to be invited to the workspace with the self-provisioner role. Namely, create an account workspace-self-provisioner of the self-provisioner role, and use this account to create a project (for example, test). In this tutorial, you log in as workspace-self-provisioner and work in the project test in the workspace demo-workspace.

    • Knowledge of Helm charts and PromQL.

    Hands-on Lab

    Step 1: Prepare the image of a sample web application

    The sample web application exposes a user-defined metric called myapp_processed_ops_total. It is a counter type metric that counts the number of operations that have been processed. The counter increases automatically by one every 2 seconds.

    This sample application exposes application-specific metrics via the endpoint http://localhost:2112/metrics.

    In this tutorial, you use the made-ready image kubespheredev/promethues-example-app. The source code can be found in kubesphere/prometheus-example-app. You can also follow Instrument A Go Application For Prometheus in the official documentation of Prometheus.

    Step 2: Pack the application into a Helm chart

    Pack the Deployment, Service, and ServiceMonitor YAML template into a Helm chart for reuse. In the Deployment and Service template, you define the sample web container and the port for the metrics endpoint. ServiceMonitor is a custom resource defined and used by Prometheus Operator. It connects your application and KubeSphere monitoring engine (Prometheus) so that the engine knows where and how to scrape metrics. In future releases, KubeSphere will provide a graphical user interface for easy operation.

    Find the source code in the folder helm in kubesphere/prometheus-example-app. The Helm chart package is made ready and is named prometheus-example-app-0.1.0.tgz. Please download the .tgz file and you will use it in the next step.

    Step 3: Upload the Helm chart

    1. Go to the workspace Overview page of demo-workspace and navigate to App Templates.

      app-template-create

    2. Click Create and upload prometheus-example-app-0.1.0.tgz as images below.

      click-create-app-template

      click-upload-app-template

      click-upload-app-template-2

      click-upload-app-template-4

      click-upload-app-template-5

      click-upload-app-template-6

    Step 4: Deploy the sample web application

    You need to deploy the sample web application into test. For demonstration purposes, you can simply run a test deployment.

    1. Click prometheus-example-app.

      deploy-sample-web-1

    2. Expand the menu and click Test Deploy.

      deploy-sample-web-2

      deploy-sample-web-3

    3. Make sure you deploy the sample web application in test and click Next.

      deploy-sample-web-4

    4. Make sure serviceMonitor.enabled is set to true and click Deploy.

      deploy-sample-web-5

      deploy-sample-web-6

    5. In Workloads of the project test, wait until the sample web application is up and running.

      create-dashboard-1

    Step 5: Create a monitoring dashboard

    This section guides you on how to create a dashboard from scratch. You will create a text chart showing the total number of processed operations and a line chart for displaying the operation rate.

    1. Navigate to Custom Monitoring and click Create.

      create-dashboard-2

    2. Set a name (for example, sample-web) and click Create.

      create-dashboard-3

    3. Enter a title in the top left corner (for example, Sample Web Overview).

      create-dashboard-4

    4. Click the plus icon on the left column to create a text chart.

      create-dashboard-5

    5. Type the PromQL expression myapp_processed_ops_total in the field Monitoring Metrics and give a chart name (for example, Operation Count). Click √ in the bottom right corner to continue.

      create-dashboard-6

    6. Click Add Monitoring Item to create a line chart.

      create-dashboard-7

      create-dashboard-8

    7. Type the PromQL expression irate(myapp_processed_ops_total[3m]) for Monitoring Metrics and name the chart Operation Rate. To improve the appearance, you can set Metric Name to {{service}}. It will name each line with the value of the metric label service. Next, set Decimal Places to 2 so that the result will be truncated to two decimal places.

      create-dashboard-9

    8. Click Save Template to save it.

      create-dashboard-10

    Previous Previous : Monitor MySQL
    What’s on this Page