Skip to content

Commit f95e54b

Browse files
feat: Adding Feature Server to components docs (feast-dev#4868)
Signed-off-by: Francisco Javier Arceo <farceo@redhat.com>
1 parent c15f4cc commit f95e54b

File tree

4 files changed

+47
-0
lines changed

4 files changed

+47
-0
lines changed

docs/SUMMARY.md

+1
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@
3232
* [Registry](getting-started/components/registry.md)
3333
* [Offline store](getting-started/components/offline-store.md)
3434
* [Online store](getting-started/components/online-store.md)
35+
* [Feature server](getting-started/components/feature-server.md)
3536
* [Batch Materialization Engine](getting-started/components/batch-materialization-engine.md)
3637
* [Provider](getting-started/components/provider.md)
3738
* [Authorization Manager](getting-started/components/authz_manager.md)

docs/getting-started/components/README.md

+4
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,10 @@
1212
[online-store.md](online-store.md)
1313
{% endcontent-ref %}
1414

15+
{% content-ref url="feature-server.md" %}
16+
[feature-server.md](feature-server.md)
17+
{% endcontent-ref %}
18+
1519
{% content-ref url="batch-materialization-engine.md" %}
1620
[batch-materialization-engine.md](batch-materialization-engine.md)
1721
{% endcontent-ref %}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Feature Server
2+
3+
The Feature Server is a core architectural component in Feast, designed to provide low-latency feature retrieval and updates for machine learning applications.
4+
5+
It is a REST API server built using [FastAPI](https://fastapi.tiangolo.com/) and exposes a limited set of endpoints to serve features, push data, and support materialization operations. The server is scalable, flexible, and designed to work seamlessly with various deployment environments, including local setups and cloud-based systems.
6+
7+
## Motivation
8+
9+
In machine learning workflows, real-time access to feature values is critical for enabling low-latency predictions. The Feature Server simplifies this requirement by:
10+
11+
1. **Serving Features:** Allowing clients to retrieve feature values for specific entities in real-time, reducing the complexity of direct interactions with the online store.
12+
2. **Data Integration:** Providing endpoints to push feature data directly into the online or offline store, ensuring data freshness and consistency.
13+
3. **Scalability:** Supporting horizontal scaling to handle high request volumes efficiently.
14+
4. **Standardized API:** Exposing HTTP/JSON endpoints that integrate seamlessly with various programming languages and ML pipelines.
15+
5. **Secure Communication:** Supporting TLS (SSL) for secure data transmission in production environments.
16+
17+
## Architecture
18+
19+
The Feature Server operates as a stateless service backed by two key components:
20+
21+
- **[Online Store](./online-store.md):** The primary data store used for low-latency feature retrieval.
22+
- **[Registry](./registry.md):** The metadata store that defines feature sets, feature views, and their relationships to entities.
23+
24+
## Key Features
25+
26+
1. **RESTful API:** Provides standardized endpoints for feature retrieval and data pushing.
27+
2. **CLI Integration:** Easily managed through the Feast CLI with commands like `feast serve`.
28+
3. **Flexible Deployment:** Can be deployed locally, via Docker, or on Kubernetes using Helm charts.
29+
4. **Scalability:** Designed for distributed deployments to handle large-scale workloads.
30+
5. **TLS Support:** Ensures secure communication in production setups.
31+
32+
## Endpoints Overview
33+
34+
| Endpoint | Description |
35+
| -------------------------- | ----------------------------------------------------------------------- |
36+
| `/get-online-features` | Retrieves feature values for specified entities and feature references. |
37+
| `/push` | Pushes feature data to the online and/or offline store. |
38+
| `/materialize` | Materializes features within a specific time range to the online store. |
39+
| `/materialize-incremental` | Incrementally materializes features up to the current timestamp. |
40+

docs/getting-started/components/overview.md

+2
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@
1313
* **Deploy Model:** The trained model binary (and list of features) are deployed into a model serving system. This step is not executed by Feast.
1414
* **Prediction:** A backend system makes a request for a prediction from the model serving service.
1515
* **Get Online Features:** The model serving service makes a request to the Feast Online Serving service for online features using a Feast SDK.
16+
* **Feature Retrieval:** The online serving service retrieves the latest feature values from the online store and returns them to the model serving service.
1617

1718
## Components
1819

@@ -24,6 +25,7 @@ A complete Feast deployment contains the following components:
2425
* Materialize (load) feature values into the online store.
2526
* Build and retrieve training datasets from the offline store.
2627
* Retrieve online features.
28+
* **Feature Server:** The Feature Server is a REST API server that serves feature values for a given entity key and feature reference. The Feature Server is designed to be horizontally scalable and can be deployed in a distributed manner.
2729
* **Stream Processor:** The Stream Processor can be used to ingest feature data from streams and write it into the online or offline stores. Currently, there's an experimental Spark processor that's able to consume data from Kafka.
2830
* **Batch Materialization Engine:** The [Batch Materialization Engine](batch-materialization-engine.md) component launches a process which loads data into the online store from the offline store. By default, Feast uses a local in-process engine implementation to materialize data. However, additional infrastructure can be used for a more scalable materialization process.
2931
* **Online Store:** The online store is a database that stores only the latest feature values for each entity. The online store is either populated through materialization jobs or through [stream ingestion](../../reference/data-sources/push.md).

0 commit comments

Comments
 (0)