NATS中文开发文档:监控连接

管理与服务器的交互主要是客户机库的工作,但大多数库也提供了一些对幕后发生的事情的了解。
例如,客户端库可以提供一种机制来获取连接的当前状态:

nc, err := nats.Connect("demo.nats.io", nats.Name("API Example"))
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

getStatusTxt := func(nc *nats.Conn) string {
    switch nc.Status() {
    case nats.CONNECTED:
        return "Connected"
    case nats.CLOSED:
        return "Closed"
    default:
        return "Other"
    }
}
log.Printf("The connection is %v\n", getStatusTxt(nc))

nc.Close()

log.Printf("The connection is %v\n", getStatusTxt(nc))

监听连接事件

如果对连接状态感兴趣,很可能对了解状态何时更改也有兴趣。大多数(如果不是全部的话)NATS客户端库提供了一种方法来监听与连接及其状态相关的事件。
这些侦听器的实际API依赖于语言,但以下示例显示了一些更常见的用例。有关更具体的说明,请参阅正在使用的客户端库的API文档。
连接事件可能包括正在关闭、断开或重新连接的连接。重新连接涉及断开连接和连接,但根据库的实现,在客户端尝试查找服务器或服务器重新启动时,还可能包括多个断开连接。

// There is not a single listener for connection events in the NATS Go Client.
// Instead, you can set individual event handlers using:
nc, err := nats.Connect("demo.nats.io",
    nats.DisconnectErrHandler(func(_ *nats.Conn, err error) {
        log.Printf("client disconnected: %v", err)
    }),
    nats.ReconnectHandler(func(_ *nats.Conn) {
        log.Printf("client reconnected")
    }),
    nats.ClosedHandler(func(_ *nats.Conn) {
        log.Printf("client closed")
    }))
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

DisconnectHandler(cb ConnHandler)
ReconnectHandler(cb ConnHandler)
ClosedHandler(cb ConnHandler)
DiscoveredServersHandler(cb ConnHandler)
ErrorHandler(cb ErrHandler)
监听新服务器

使用群集时,可以添加或更改服务器。某些客户端允许您侦听此通知:

// Be notified if a new server joins the cluster.
// Print all the known servers and the only the ones that were discovered.
nc, err := nats.Connect("demo.nats.io",
    nats.DiscoveredServersHandler(func(nc *nats.Conn) {
        log.Printf("Known servers: %v\n", nc.Servers())
        log.Printf("Discovered servers: %v\n", nc.DiscoveredServers())
    }))
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

// Do something with the connection
对错误监听

客户端库可以将服务器到客户端的错误与事件分开。许多服务器事件不由应用程序代码处理,导致连接关闭。监听错误对于调试问题非常有用。

// Set the callback that will be invoked when an asynchronous error occurs.
nc, err := nats.Connect("demo.nats.io",
    nats.ErrorHandler(func(_ *nats.Conn, _ *nats.Subscription, err error) {
        log.Printf("Error: %v", err)
    }))
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

// Do something with the connection

Slow Consumers

NATS的设计目的是在服务器中快速移动消息。因此,NATS依赖于应用程序来考虑和响应不断变化的消息速率。服务器会进行一些阻抗匹配,但如果客户端速度太慢,服务器最终会通过关闭连接来切断它们。这些切断的连接被称为慢用户。

一些库处理突发消息通信的一种方法是缓冲订阅的传入消息。因此,如果一个应用程序每秒可以处理10条消息,并且有时每秒接收20条消息,则库可以保存额外的10条消息,以便给应用程序足够的时间来赶上。对于服务器,应用程序似乎正在处理消息并认为连接正常。大多数客户端库都会通知应用程序有一个SlowConsumer错误并丢弃消息。

从服务器接收和删除消息可以保持与服务器的连接正常,但会创建应用程序需求。有几种常见的模式:

  • 使用“请求/答复”来限制发件人并防止订阅服务器过载
  • 使用具有多个订阅者的队列来分割工作
  • 使用类似于NATS流的持久化消息

缓存传入消息的库可以在传入队列或挂起消息上提供两个控件。如果问题是突发的发布服务器,而不是持续的性能不匹配,则这些功能非常有用。在生产中禁用这些限制可能是危险的,尽管将这些限制设置为0可能有助于发现问题,但在生产中也是危险的。
检查库文档中的默认设置,并支持禁用这些限制。
传入的缓存通常是每个订阅服务器的缓存,但请再次检查客户端库的特定文档。

按计数和字节限制Incoming/Pending Messages

传入队列可以受到限制的第一种方式是消息计数。第二种限制传入队列的方法是按总大小。例如,要将传入缓存限制为1000条消息或5mb(以先到者为准):

nc, err := nats.Connect("demo.nats.io")
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

// Subscribe
sub1, err := nc.Subscribe("updates", func(m *nats.Msg) {})
if err != nil {
    log.Fatal(err)
}

// Set limits of 1000 messages or 5MB, whichever comes first
sub1.SetPendingLimits(1000, 5*1024*1024)

// Subscribe
sub2, err := nc.Subscribe("updates", func(m *nats.Msg) {})
if err != nil {
    log.Fatal(err)
}

// Set no limits for this subscription
sub2.SetPendingLimits(-1, -1)

// Close the connection
nc.Close()
检测慢消息者并检查丢弃的消息

当检测到慢速使用者并且消息即将丢弃时,库可能会通知应用程序。此过程可能与其他错误类似,也可能涉及自定义回调。
有些库(如Java)不会在每个丢弃的消息上发送此通知,因为这可能会比较烦躁。相反,通知可能会在订户每次落后时发送一次。库还可以提供一种方法来获取丢弃消息的计数,以便应用程序至少可以检测到问题正在发生。

// Set the callback that will be invoked when an asynchronous error occurs.
nc, err := nats.Connect("demo.nats.io", nats.ErrorHandler(logSlowConsumer))
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

// Do something with the connection
已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 1024 设计师:上身试试 返回首页