Learn Layer5

A sample application for learning how to service mesh and for validating SMI conformance
Alternatives To Learn Layer5
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Linkerd29,90312a day ago108March 23, 2022249apache-2.0Go
Ultralight, security-first service mesh for Kubernetes. Main repo for Linkerd 2.x.
3 days ago33August 02, 202350apache-2.0Go
A Cloud Native traffic orchestration system
Linkerd5,372117 months ago21November 17, 2017146apache-2.0Scala
Old repo for Linkerd 1.x. See the linkerd2 repo for Linkerd 2.x.
Mosn4,2472a month ago95April 25, 2023268apache-2.0Go
The Cloud-Native Network Proxy Platform
Kuma3,2882a day ago162April 22, 2021377apache-2.0Go
🐻 The multi-zone service mesh for containers, Kubernetes and VMs. Built with Envoy. CNCF Sandbox Project.
Kiali3,194212a day ago394September 20, 2022157apache-2.0TypeScript
Kiali project, observability for the Istio service mesh
Osm2,58593 months ago364April 20, 2023apache-2.0Go
Open Service Mesh (OSM) is a lightweight, extensible, cloud native service mesh that allows users to uniformly manage, secure, and get out-of-the-box observability features for highly dynamic microservice environments.
Coolstore Microservices2,215
7 months ago25mitC#
A full-stack .NET microservices build on Dapr and Tye
6 months ago30August 19, 202236apache-2.0Go
Traefik Mesh - Simpler Service Mesh
Kubernetes Vagrant Centos Cluster1,827
a year ago17apache-2.0Shell
Setting up a distributed Kubernetes cluster along with Istio service mesh locally with Vagrant and VirtualBox, only PoC or Demo use.
Alternatives To Learn Layer5
Select To Compare

Alternative Project Comparisons

Shows a dark layer5 logo in light mode and a white logo in dark mode

GitHub contributors GitHub Docker Pulls Go Report Card GitHub issues by-label Website Twitter Follow Slack CII Best Practices

Learn Layer5 (learn to service mesh)

The Learn Layer5 sample application is to be available for use across all service meshes that Meshery supports and is to used as:

Application Architecture

The Learn Layer5 application includes three services: app-a, app-b, and app-c. Though they are different services, they are defined using the same app (source code in ./service). Each service is listening on port 9091/tcp.


The following are the routes defined by the service app and their functionality.

POST /call

This route makes the service make requests to another service. Metrics are collected for this route. sample usage given below:

# Command
curl --location --request POST 'http://service-a:9091/call' \
--header 'Content-Type: application/json' \
--data-raw '{
"url": "http://service-b:9091/call",
"body": "{\r\n\"url\": \"http:\/\/service-c:9091\/echo\",\r\n\"body\": \"\",\r\n\"method\": \"GET\"\r\n}",
"method": "POST",
"headers": {

# No Output
GET /echo HTTP/1.1
Host: service-c:9091
User-Agent: Go-http-client/1.1
Accept-Encoding: gzip
Servicename: Service-B

In the above example, we are making a post request to service-a with the body:

  "url": "http://service-b:9091/call",
  "body": "{\r\n\"url\": \"http:\/\/service-c:9091\/echo\",\r\n\"body\": \"\",\r\n\"method\": \"GET\"\r\n}",
  "method": "POST",
  "headers": {

This will make service-a to make a POST request to http://service-b:9091/call with the headers specified above, and the body:

  "url": "http://service-c:9091/echo",
  "method": "GET"

This inturn will make service-b to make a GET request to http://service-c:9091/echo.

GET /metrics

Gets the metrics from service-a

# Command
curl --location --request GET 'http://service-b:9091/metrics'
# Output
    "ReqReceived": [
    "RespSucceeded": [
            "URL": "http://service-c:9091/echo",
            "Method": "GET",
            "Headers": null
    "RespFailed": []
  • In ReqReceived we see list of requests service-b received and from whom it received. Here we see service-A. Actually each of the service sets a header ServiceName which is read by the service to determine the sender.
  • As service-b made a request to service-c and the request succeeded, we can see the details in the list of successful responses (RespSucceeded).

DELETE /metrics

Clears the counters in service

# Command
curl --location --request DELETE ''
# No Output

Note: metrics are collected only for /call and /echo.

Service Mesh Interface (SMI) Conformance

The learn-layer5 application serves as a sample application to validate the conformance of any service mesh with the SMI specifications. To verify SMI conformance, run Meshery and the Meshery adapter for the specific service mesh you wish to test. Invoke the suite of SMI conformance tests on the specific service mesh you would like to validate.

Invoking conformance tests

As a Service Mesh user Meshery allows you to schedule tests and invoke them programmatically. Meshery will store these test results and allow you to retrieve them later.

As a Service Mesh maker Meshery guarantees provenance of these tests and facilitates the public publicing of this suite of tests results into a versioned, public matrix of conformance status (consisting of both supported capabilities and test compliance).

If you’re using Learn Layer5 or if you like the project, please star this repository to show your support! 🤩

Community and Contributing

Our projects are community-built and welcome collaboration. 👍 Be sure to see the Layer5 Community Welcome Guide for a tour of resources available to you and jump into our Slack! Contributors are expected to adhere to the CNCF Code of Conduct. Shows an illustrated light mode meshery logo in light color mode and a dark mode meshery logo dark color mode.

Layer5 Service Mesh Community

✔️ Join any or all of the weekly meetings on the community calendar.
✔️ Watch community meeting recordings.
✔️ Access the community drive.
✔️ Discuss in the Community Forum.

Not sure where to start? Grab an open issue with the help-wanted label.

About Layer5

Layer5's cloud native application and infrastructure management software enables organizations to expect more from their infrastructure. We embrace developer-defined infrastructure. We empower engineer to change how they write applications, support operators in rethinking how they run modern infrastructure and enable product owners to regain full control over their product portfolio.


This repository and site are available as open source under the terms of the Apache 2.0 License.

Popular Mesh Projects
Popular Service Mesh Projects
Popular Graphics Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Service Mesh