App Owner Troubleshooting Guide

Welcome to the Tetrate Service Bridge 'Application Owner TroubleShooting Guide'.

Who is is this Guide for?

If you are responsible for an application that is deployed on a TSB (Tetrate Service Bridge)-powered platform, then this guide is for you.

What is Tetrate Service Bridge (TSB)?

TSB is a service-mesh platform for large multi-cluster, multi-tenant deployments. It is used by platform owners to securely network clusters together, manage traffic across these clusters, maintain availability and to define access and organizational policies for users and services.

Application Owners can use TSB's comprehensive monitoring capabilities to observe and troubleshoot their applications.

Troubleshooting for Application Owners

Your application has been deployed on a TSB-managed Kubernetes Cluster. Perhaps you've been paged with an availability alert, or perhaps you wish to investigate a performance issue with your application.

This guide will take you through the steps to troubleshoot your application, so that you can determine if the issue resides with your application, or if it needs to be raised to the attention of your platform team for further investigation.

To get started, you'll need the following information and resources:

• Your application details - the hostname and path which is used to access the application, and the protocol (e.g. HTTP or HTTPS) and port
• The cluster, namespace and service name where the application is deployed
• A TSB login with appropriate RBAC permissions to begin troubleshooting the issue

The Tetrate platform provides a set of tools, metrics and reports to assist you in troubleshooting an application. In the following steps, you will see how to use:

• The Service Registry, which is a database of services that the Tetrate platform has discovered on the clusters. Inspect the Service Registry to determine what the Tetrate platform has learnt about the services you have deployed in your Workspaces
• Metrics for your services are reported and stored by the Tetrate platform, and can be viewed in near-real time and also across historical time windows. Identify errors, latency and other traffic data, and view a calculated ApDex score for the service.
• Logs from the Envoy Proxy and from your service can be streamed in real-time to watch requests and detect internal warnings and errors reported by your service
• Traces, which sample a small proportion of requests, enable you to view the full span of a transaction through the edge gateways to the various back-end services
• The Topology Display presents a powerful graph-like display showing the request flow from edge gateways to your application and its back-end dependencies
• The Configuration Status report helps to diagnose any configuration errors - rejected configuration, or configuration that has not fully propagated

Next Steps

If you're familiar with the Tetrate platform, you can jump straight to the Troubleshooting Quick Reference, which provides outlines for troubleshooting various issues.

If you'd like a detailed walkthrough of the Troubleshooting process, go to the Troubleshooting Guide.