> For the complete documentation index, see [llms.txt](https://tarscloud.gitbook.io/tarsdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tarscloud.gitbook.io/tarsdocs/tarscpp/tars-server-thread.md).

# 服务线程说明文档

## 1. 概述

Tars C++框架服务是单进程多线程RPC系统。本文讲述一个标准的Tars C++框架服务启动的线程数目，以及各线程的职责。

## 2. Tars C++框架服务线程组成

| 启动者    | 线程功能                                                               | 线程数目 |
| ------ | ------------------------------------------------------------------ | ---- |
| SERVER | 服务主线程，负责服务端初始化                                                     | 1    |
| SERVER | 服务端网络线程，负责服务端网络收发数据包（数目可配置）                                        | 可配置  |
| SERVER | 管理端口业务逻辑线程，负责接受和处理用户自定义命令、服务关闭命令等                                  | 1    |
| SERVER | 时间辅助线程，负责定期计算时间，减少系统对gettimeofday的调用                               | 1    |
| SERVER | 滚动日志线程，负责本地的文件创建和日志写入                                              | 1    |
| SERVER | 本地日志线程，负责本地、染色日志的文件创建和日志写入（有打印按天日志或者相关初始化，线程才会创建）                  | 1    |
| SERVER | 远程日志线程，负责同步本地、染色日志到远程（有打印按天日志或者相关初始化，线程才会创建）                       | 1    |
| SERVER | 业务逻辑处理线程，负责处理用户业务逻辑，完成服务的主要功能。（默认各个ServantObj有自己对应的业务逻辑处理线程，也可以共用） | 可配置  |
| 通信器    | 客户端网络线程，负责管理对外服务链接、监听读写事件、网络读写                                     | 可配置  |
| 通信器    | 统计属性上报线程，负责收集统计和属性信息，定时同步到stat和property                            | 1    |
| 通信器    | 异步回调线程，负责执行异步回调函数，客户端每个网络线程有自己的异步线程                                | 可配置  |

## 3. 分析运行中线程任务

我们观察一个运行中的TAF框架服务，看下每个线程的特征，并对各个线程功能做下区分。

实验场景：

> * 服务端配置1个ServantObj，其配置5个业务逻辑线程。

> * 服务端配置1个网络线程

> * 客户端配置2个网络线程

> * 异步回调线程设置为2个。

按照上节所述的线程启动策略，这种场景下这个服务应该有：

7（固定数）+ 1(服务端网络线程数目) + 5（业务处理线程数目）+ 2(客户端网络线程数目) + 2（异步回调线程数目）\* 2(客户端网络线程数目) = 19个线程。

## 4. 改变线程数目的方法

上面看到了一个标准的Tars C++服务是如何组成的，凡是表明线程数目为1的部分是框架内部实现的，用户不能改变数目。

能改变的就是服务端网络线程、业务逻辑处理线程、客户端网络线程、异步回调处理线程。

### 4.1. 改变业务处理线程数目的方法

改变业务逻辑处理线程数据，可以在Tars管理平台配置Servant对象时，在“线程数”输入自己想要的线程，那么框架将会为本Servant启动相应的线程数。

注意：

如果服务拥有两个Servant对象，分别属于不同的线程组，计算线程数目时，我们只需将不同Servant对象的线程数简单相加即可。

### 4.2. 改变服务端网络线程、客户端网络线程、异步回调处理线程的方法

如果要改变服务端网络线程、客户端网络线程、异步回调线程数目，可以在模版上修改，或者增加对应的服务私有模版。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tarscloud.gitbook.io/tarsdocs/tarscpp/tars-server-thread.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.