go-kit 目录
#go-kit
* auth/basic
* auth/casbin
* auth/jwt
* circuitbreaker 断路器实现了断路器模式。
* cmd/kitgen
* cmd/kitgen/templates
endpoint: 端点定义了RPC的抽象
examples
- examples/addsvc/cmd/addcli
- examples/addsvc/cmd/addsvc
- examples/addsvc/pb
- examples/addsvc/pkg/addendpoint
- examples/addsvc/pkg/addservice
- examples/addsvc/pkg/addtransport
- examples/addsvc/thrift/gen-go/addsvc
- examples/addsvc/thrift/gen-go/addsvc/add_service-remote
- examples/apigateway
- examples/profilesvc
* examples/profilesvc/client 客户端根据预定义的Consul服务名称和相关标签提供一个profilevc客户端。
* examples/shipping
* examples/shipping/booking预订提供了预订货物的用例。
* examples/shipping/cargo 域模型的核心。
* examples/shipping/handling提供注册事件的用例。
* examples/shipping/inmem 提供所有域存储库的内存实现。
* examples/shipping/inspection提供了检查的方式
* examples/shipping/location location provides the Location aggregate.
* examples/shipping/routing Package routing provides the routing domain service.
* examples/shipping/tracking Package tracking provides the use-case of tracking a cargo.
* examples/shipping/voyage Package voyage provides the Voyage aggregate.
-
examples/stringsvc1
-
examples/stringsvc2
-
examples/stringsvc3
-
examples/stringsvc4
日志包，提供了结构化的logger
* log/deprecated_levels
* log/level Package level implements leveled logging on top of Go kit’s log package.
* log/logrus Package logrus provides an adapter to the go-kit log.Logger interface.
* log/syslog
* log/term Package term provides tools for logging to a terminal.
* log/zap
metrics 为应用程序检测提供了框架
- metrics/cloudwatch
- metrics/cloudwatch2 Package cloudwatch2 emits all data as a StatisticsSet (rather than a singular Value) to CloudWatch via the aws-sdk-go-v2 SDK.
- metrics/discard Package discard provides a no-op metrics backend.
- metrics/dogstatsd Package dogstatsd provides a DogStatsD backend for package metrics.
- metrics/expvar Package expvar provides expvar backends for metrics.
- metrics/generic Package generic implements generic versions of each of the metric types.
- metrics/graphite Package graphite provides a Graphite backend for metrics.
- metrics/influx Package influx provides an InfluxDB implementation for metrics.
- metrics/influxstatsd Package influxstatsd provides support for InfluxData’s StatsD Telegraf plugin.
- metrics/internal/convert Package convert provides a way to use Counters, Histograms, or Gauges as one of the other types
- metrics/internal/lv
- metrics/internal/ratemap Package ratemap implements a goroutine-safe map of string to float64.
- metrics/multi Package multi provides adapters that send observations to multiple metrics simultaneously.
- metrics/pcp
- metrics/prometheus Package prometheus provides Prometheus implementations for metrics.
- metrics/provider Package provider provides a factory-like abstraction for metrics backends.
- metrics/statsd Package statsd provides a StatsD backend for package metrics.
- metrics/teststat Package teststat provides helpers for testing metrics backends.
ratelimit
- ratelimit
sd提供与服务发现相关的实用程序
- sd/consul Package consul provides Instancer and Registrar implementations for Consul.
- sd/dnssrv Package dnssrv provides an Instancer implementation for DNS SRV records.
- sd/etcd Package etcd provides an Instancer and Registrar implementation for etcd.
- sd/etcdv3 Package etcdv3 provides an Instancer and Registrar implementation for etcd v3.
- sd/eureka Package eureka provides Instancer and Registrar implementations for Netflix OSS’s Eureka
- sd/internal/instance
- sd/lb Package lb implements the client-side load balancer pattern.
- sd/zk Package zk provides Instancer and Registrar implementations for ZooKeeper.
tracing 提供用于分布式跟踪的帮助程序和绑定
- tracing/opencensus Package opencensus provides Go kit integration to the OpenCensus project.
- tracing/opentracing Package opentracing provides Go kit integration to the OpenTracing project.
- tracing/zipkin Package zipkin provides Go kit integration to the OpenZipkin project through the use of zipkin-go, the official OpenZipkin tracer implementation for Go.
transport 包含适用于所有受支持transport的帮手
- transport/amqp Package amqp implements an AMQP transport.
- transport/awslambda Package awslambda provides an AWS Lambda transport layer.
transport/grpc 提供了一个gRPC 对endpoints绑定.
- transport/grpc/_grpc_test
- transport/grpc/_grpc_test/pb
transport/http 对endpoints生成一个目标 HTTP
- transport/http/jsonrpc Package jsonrpc provides a JSON RPC (v2.0) binding for endpoints.
- transport/http/proto
- transport/httprp Package httprp provides an HTTP reverse-proxy transport.
- transport/nats Package nats provides a NATS transport.
conn提供与连接有关的实用程序。
- util/conn
go-kit介绍 （以下非本人翻译，转自 简书 李小贱AA）
go kit 是一个分布式的开发工具集，在大型的组织(业务)中可以用来构建微服务。其解决了分布式系统中常见的问题，因此，使用者可以将精力集中在业务逻辑上。
##Go-kit 组件介绍
2.1 Endpoint
Endpoint：Go-kit 首选解决了RPC消息模式。其中使用了一个抽象的endpoint来为每一个RPC建立模型。
endpoint通过被一个server进行实现(implement),或是被一个client调用。这是很多Go-kit 组件的基本构建代码块
2.2 Circuit breaker(回路断路器)
回路断路器:模块提供额许多流行的回路断路lib的端点(endpoint)适配器。回路断路器可以避免雪崩，并且提高了针对间歇性错误的弹性.每个client的端点都应该封装(wrapped)在回路断路器中。
2.3 Rate limiter(限流器)
限流器：模块提供了到限流器代码包的端点适配器。限流器对服务端(server-client) 和 客户端(client-side) 同等生效。使用限流器可以强制进，出 请求量在阈值上限以下。
2.4 Transport(传输层)
传输层：提供了将特定的序列化算法绑定到端点的辅助方法。当前，Go kit 只针对JSON和HTTP提供了辅助方法。如果你的组织使用了完整功能的传输层，典型的方案是使用GO在传输层提供的函数。 Go-kit 并不需要来做太多的事情。这些情况，可以查阅代码例子来理解如何为你的端点写一个适配器。
2.5 Logging(日志)
服务产生的日志是会被延迟消费（使用）的，或者是人或者是机器（来使用）。人可能会对调试错误、跟踪特殊的请求感兴趣。机器可能会对统计那些有趣的事件，或是对离线处理的结果进行聚合。这两种情况，日志消息的结构化和可操作性是很重要的。Go kit的log模块针对这些实践提供了最好的设计。
2.6 Metrics/Instrumentation 度量/仪表盘
直到服务经过了跟踪计数、延迟、健康状况和其他的周期性的或针对每个请求信息的仪表盘化，才能被认为是“生产环境”完备的。Go kit 的metric模块为你的服务提供了通用并健壮的接口集合。可以绑定到常用的后端服务，比如expvar、statsd、Prometheus。
2.7 Request tracing（请求跟踪）
随着你的基础设施的增长，能够跟踪一个请求变得越来越重要，因为它可以在多个服务中进行穿梭并回到用户。Go kit的tracing模块提供了为端点和传输的增强性的绑定功能，以捕捉关于请求的信息，并把它们发送到跟踪系统中。（当前支持Zipkin，计划支持Appdash
2.8 Service discovery and load balancing（服务发现和负载均衡）
如果你的服务调用了其他的服务，需要知道如何找到它（另一个服务），并且应该智能的将负载在这些发现的实例上铺开（即，让被发现的实例智能的分担服务压力）。Go kit的loadbalancer模块提供了客户端端点的中间件来解决这类问题，无论你是使用的静态的主机名还是IP地址，或是 DNS的SRV记录，Consul，etcd 或是 Zookeeper。并且，如果你使用定制的系统，也可以非常容易的编写你自己的Publisher，以使用 Go kit 提供的负载均衡策略。（目前，支持静态主机名、etcd、Consul、Zookeeper）