UberFx is a flexible, modularized framework for building robust and performant services. It takes care of the boilerplate code and lets you focus on your application logic.
Beta. Expect minor API changes and bug fixes. See our changelog for more.
UberFx builds the following into your service:
- Logging backed by the zap logger
- Configuration provider that seamlessly merges static and dynamic config
- Application-level as well as runtime metrics for effective monitoring
- Request tracing for application-level instrumentation
- Context-aware logging for easy debugging
- RPC module with Thrift interfaces for microservices
- HTTP module with intelligent defaults for web applications
- Task module for executing async tasks durably
To get a feel for what an UberFx service looks like, see our examples.
A service is a container for a set of modules and controls their lifecycle. A service can have any number of modules, each responsible for a specific type of functionality, such as a Kafka message ingestion, exposing an HTTP server, or a set of RPC service endpoints.
The core service is responsible for loading basic configuration and starting and stopping a set of these modules. Each module gets a reference to the service to access standard values such as the service name or basic configuration.
Read more about the service model
The top-level packages contain the nuts and bolts useful for a fully-fledged
service. That said, none (except for service) requires an instance or even
the idea of a service. You can use the packages independently.
If, for example, you only want use the configuration logic from UberFx, you
can import go.uber.org/fx/config and use it in a standalone CLI app.
The service package contains logic specific to a running service. config
is separate from service.
A modules is a pluggable component that provides an encapsulated set of functionality, and all modules are managed by the service.
Implemented modules:
- HTTP server
- TChannel server
- Async task execution
Planned modules:
- Kafka ingester
- Delayed jobs
You give your modules named keys for the purpose of looking up their configuration. This naming is arbitrary and only needs to be unique across modules. We do this because it's possible for a service to have multiple modules of the same type, such as multiple Kafka ingesters.
modules:
yarpc:
bind: :28941
advertiseName: kvserver
uhttp:
port: 8080
timeout: 60sIn this example, a module named: "yarpc" would look up its advertise name as
modules.yarpc.advertiseName.
UberFx exposes a simple, consistent way to track metrics and is built on top of Tally.
Internally, this uses a pluggable mechanism for reporting these values, so they
can be reported to M3, logging, etc., at the service owner's discretion.
By default, the metrics are not reported (using a tally.NoopScope).
UberFx introduces a simplified configuration model that provides a consistent interface to configuration from pluggable configuration sources. This interface defines methods for accessing values directly or into strongly typed structs.
Read more about configuration.
UberFx is compatible with Go 1.7 and above.