# joylive-agent

**Repository Path**: JD-opensource/joylive-agent

## Basic Information

- **Project Name**: joylive-agent
- **Description**: Java bytecode enhancement framework for traffic governance in multi-live (unit) scenarios. 基于字节码增强的面向应用多活和单元化的微服务流量治理框架。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 33
- **Forks**: 10
- **Created**: 2024-07-08
- **Last Updated**: 2025-06-17

## Categories & Tags

**Categories**: microservice

**Tags**: None

## README

# joylive-agent

[![Build](https://github.com/jd-opensource/joylive-agent/actions/workflows/build.yml/badge.svg)](https://github.com/jd-opensource/joylive-agent/actions/workflows/build.yml)
![License](https://img.shields.io/github/license/jd-opensource/joylive-agent.svg)
[![Maven Central](https://img.shields.io/maven-central/v/com.jd.live/joylive-agent.svg?label=maven%20central)](https://search.maven.org/search?q=g:com.jd.live)
[![GitHub repo](https://img.shields.io/badge/GitHub-repo-blue)](https://github.com/jd-opensource/joylive-agent)
[![GitHub release](https://img.shields.io/github/release/jd-opensource/joylive-agent.svg)](https://github.com/jd-opensource/joylive-agent/releases)
[![Percentage of issues still open](http://isitmaintained.com/badge/open/jd-opensource/joylive-agent.svg)](http://isitmaintained.com/project/jd-opensource/joylive-agent "Percentage of issues still open")
[![Slack Status](https://img.shields.io/badge/slack-join_chat-white.svg?logo=slack&style=social)](https://joylivehq.slack.com)

<img src="docs/image/weixin.png" title="该二维码有效期截止到2025/06/17" width="150"  />

[English](./README.md) | 简体中文

## 概述

微服务治理框架，基于字节码增强技术，采用微内核可扩展架构的Proxyless实现。
相对于Sidecar模式，具备高性能和低资源损耗特性。
除了支持传统的微服务治理，如熔断、限流和降级，还实现了泳道治理和应用多活的流量治理。
提供了Spring cloud hoxton/2020/2021/2022/2023/2025/2025、 Dubbo 2.6/2.7/3、SofaRpc、Rocketmq和Kafka的流量治理插件。
使企业现存的大量的Java应用，无需修改业务代码，就可以获得开箱即用的流量治理能力，支持同城、异地和多云多活场景下的流量调度，提升了业务稳定性和容灾能力。

## 架构
1. Agent在多活场景应用   
   ![pic](docs/image/architect-0.png)

2. Agent架构图   
   ![pic](docs/image/architect-1.png)

3. Agent治理原理   
   ![pic](docs/image/architect-2.png)

4. Agent基于泳道的全链路灰度   
   ![pic](docs/image/architect-3.png)

5. Agent本地分区优先策略   
   ![pic](docs/image/architect-4.png)

6. 更多请参考[架构手册](docs/cn/architect.md)

## 关联项目

1. [joylive-injector](https://github.com/jd-opensource/joylive-injector)，用于云原生场景自动注入`joylive-agent`

## 如何使用

### 需求

编译需求: JDK 17+ 与 Maven 3.2.5+

运行需求: JDK 8+

注意：使用IDEA请关闭交叉编译，如下图所示

![pic](docs/image/idea-0.jpg)


## 主要特性

1. 支持同城多活、异地多活等多种模型的流量控制；
2. 支持基于泳道的全链路灰度，QPS与并发限流，标签路由，负载均衡等微服务治理策略；
3. 支持分区本地优先和跨分区容错策略；
4. 采用字节码增强技术，对业务代码无侵入，业务性能影响最小；
5. 采用微内核架构，强类隔离，简单易用的扩展和配置体系。

## 快速开始

查看 [快速开始](./docs/cn/quickstart.md)

## 配置参考手册

查看 [配置参考手册](./docs/cn/config.md)

## 使用示例

查看 [使用示例](./docs/cn/example.md)

## 常见问题

查看 [常见问题](./docs/cn/qa.md)

## 发布历史

查看 [发布历史](./RELEASE-zh.md)

## 路线图

查看 [路线图](./docs/cn/roadmap.md)