Skip to content
Kong Logo | Kong Docs Logo
search
  • We're Hiring!
  • Docs
    • Kong Gateway
    • Kong Konnect
    • Kong Mesh
    • Plugin Hub
    • decK
    • Kubernetes Ingress Controller
    • Insomnia
    • Kuma

    • Docs contribution guidelines
  • Plugin Hub
  • Support
  • Community
  • Kong Academy
Get a Demo Start Free Trial
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Plugin Hub
  • decK
  • Kubernetes Ingress Controller
  • Insomnia
  • Kuma

  • Docs contribution guidelines
  • 3.3.x (latest)
  • 3.2.x
  • 3.1.x
  • 3.0.x
  • 2.8.x
  • 2.7.x
  • 2.6.x
  • Older Enterprise versions (2.1-2.5)
  • Older OSS versions (2.1-2.5)
  • Archive (pre-2.1)

github-edit-pageEdit this page

report-issueReport an issue

enterprise-switcher-iconSwitch to OSS

On this pageOn this page
  • Upstream and service interaction
  • Upstream configuration
Kong Gateway
3.3.x (latest)
  • Home
  • Kong Gateway
  • Key Concepts
  • Upstreams

Upstreams

Upstream refers to an API, application, or micro-service that Kong Gateway forwards requests to. In Kong Gateway, an upstream object represents a virtual hostname and can be used to health check, circuit break, and load balance incoming requests over multiple services.

Upstream and service interaction

You can configure a service to point to an upstream instead of a host. For example, if you have a service called example_service and an upstream called example_upstream, you can point example_service to example_upstream instead of specifying a host. The example_upstream upstream can then point both httpbin.org and mockbin.org. In a real environment, the upstream points to the same service running on multiple systems.

This setup allows you to load balance between upstream targets. For example, if an application is deployed across two different servers or upstream targets, Kong Gateway needs to load balance across both servers. This is so that if one of the servers (like httpbin.org in the previous example) is unavailable, it automatically detects the problem and routes all traffic to the working server (mockbin.org).

Upstream configuration

You can add upstreams to a service in Kong Gateway using the following methods:

  • Using Kong Manager
  • Using the Admin API
  • Using decK (YAML)

For more information about how to configure upstreams, see Configure Load Balancing.

Thank you for your feedback.
Was this page useful?
  • Kong
    THE CLOUD CONNECTIVITY COMPANY

    Kong powers reliable digital connections across APIs, hybrid and multi-cloud environments.

    • Company
    • Customers
    • Events
    • Investors
    • Careers Hiring!
    • Partners
    • Press
    • Contact
  • Products
    • Kong Konnect
    • Kong Gateway
    • Kong Mesh
    • Get Started
    • Pricing
  • Resources
    • eBooks
    • Webinars
    • Briefs
    • Blog
    • API Gateway
    • Microservices
  • Open Source
    • Install Kong Gateway
    • Kong Community
    • Kubernetes Ingress
    • Kuma
    • Insomnia
  • Solutions
    • Decentralize
    • Secure & Govern
    • Create a Dev Platform
    • API Gateway
    • Kubernetes
    • Service Mesh
Star
  • Terms•Privacy
© Kong Inc. 2023