# `@hive/usage`

This service takes care of handling HTTP requests for usage reporting.

The data is written to a Kafka broker, form Kafka the data is feed into clickhouse via the
`usage-ingestor` service.

## Configuration

| Name                                | Required | Description                                                                                                                                          | Example Value                                        |
| ----------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `PORT`                              | No       | The port this service is running on.                                                                                                                 | `4001`                                               |
| `TOKENS_ENDPOINT`                   | **Yes**  | The endpoint of the tokens service.                                                                                                                  | `http://127.0.0.1:6001`                              |
| `COMMERCE_ENDPOINT`                 | No       | The endpoint of the commerce service.                                                                                                                | `http://127.0.0.1:4012`                              |
| `KAFKA_TOPIC`                       | **Yes**  | The kafka topic.                                                                                                                                     | `usage_reports_v2`                                   |
| `KAFKA_CONSUMER_GROUP`              | **Yes**  | The kafka consumer group.                                                                                                                            | `usage_reports_v2`                                   |
| `KAFKA_BROKER`                      | **Yes**  | The address of the Kafka broker.                                                                                                                     | `127.0.0.1:29092`                                    |
| `KAFKA_SSL`                         | No       | Whether an SSL connection should be established to the kafka service.                                                                                | `1` (enabled) or `0` (disabled)                      |
| `KAFKA_SSL_CA_PATH`                 | No       | Refer to [TLS create secure context](https://nodejs.org/dist/latest-v8.x/docs/api/tls.html#tls_tls_createsecurecontext_options) for more information | `./path_to_ca`                                       |
| `KAFKA_SSL_CERT_PATH`               | No       | Refer to [TLS create secure context](https://nodejs.org/dist/latest-v8.x/docs/api/tls.html#tls_tls_createsecurecontext_options) for more information | `./path_to_cert`                                     |
| `KAFKA_SSL_KEY_PATH`                | No       | Refer to [TLS create secure context](https://nodejs.org/dist/latest-v8.x/docs/api/tls.html#tls_tls_createsecurecontext_options) for more information | `./path_to_key`                                      |
| `KAFKA_SASL_MECHANISM`              | No       | The mechanism used for doing SASL authentication                                                                                                     | `plain` or `scram-sha-256` or `scram-sha-512`        |
| `KAFKA_SASL_USERNAME`               | No       | The username for the SASL authentication                                                                                                             | `letmein`                                            |
| `KAFKA_SASL_PASSWORD`               | No       | Whether an SSL connection should be established to the kafka service.                                                                                | `letmein`                                            |
| `KAFKA_BUFFER_SIZE`                 | No       | The buffer size ???                                                                                                                                  | `12`                                                 |
| `KAFKA_BUFFER_INTERVAL`             | No       | The buffer interval ???                                                                                                                              | `1`                                                  |
| `KAFKA_BUFFER_DYNAMIC`              | No       | The buffer interval ???                                                                                                                              | `1`                                                  |
| `POSTGRES_SSL`                      | No       | Whether the postgres connection should be established via SSL.                                                                                       | `1` (enabled) or `0` (disabled)                      |
| `POSTGRES_HOST`                     | **Yes**  | Host of the postgres database                                                                                                                        | `127.0.0.1`                                          |
| `POSTGRES_PORT`                     | **Yes**  | Port of the postgres database                                                                                                                        | `5432`                                               |
| `POSTGRES_DB`                       | **Yes**  | Name of the postgres database.                                                                                                                       | `registry`                                           |
| `POSTGRES_USER`                     | **Yes**  | User name for accessing the postgres database.                                                                                                       | `postgres`                                           |
| `POSTGRES_PASSWORD`                 | No       | Password for accessing the postgres database.                                                                                                        | `postgres`                                           |
| `REDIS_HOST`                        | **Yes**  | The host of your redis instance.                                                                                                                     | `"127.0.0.1"`                                        |
| `REDIS_PORT`                        | **Yes**  | The port of your redis instance.                                                                                                                     | `6379`                                               |
| `REDIS_PASSWORD`                    | **Yes**  | The password of your redis instance.                                                                                                                 | `"apollorocks"`                                      |
| `REDIS_TLS_ENABLED`                 | **No**   | Enable TLS for redis connection (rediss://).                                                                                                         | `"0"`                                                |
| `ENVIRONMENT`                       | No       | The environment of your Hive app. (**Note:** This will be used for Sentry reporting.)                                                                | `staging`                                            |
| `SENTRY_DSN`                        | No       | The DSN for reporting errors to Sentry.                                                                                                              | `https://dooobars@o557896.ingest.sentry.io/12121212` |
| `SENTRY`                            | No       | Whether Sentry error reporting should be enabled.                                                                                                    | `1` (enabled) or `0` (disabled)                      |
| `PROMETHEUS_METRICS`                | No       | Whether Prometheus metrics should be enabled                                                                                                         | `1` (enabled) or `0` (disabled)                      |
| `PROMETHEUS_METRICS_LABEL_INSTANCE` | No       | The instance label added for the prometheus metrics.                                                                                                 | `usage-service`                                      |
| `PROMETHEUS_METRICS_PORT`           | No       | Port on which prometheus metrics are exposed                                                                                                         | Defaults to `10254`                                  |
| `REQUEST_LOGGING`                   | No       | Log http requests                                                                                                                                    | `1` (enabled) or `0` (disabled)                      |
| `LOG_LEVEL`                         | No       | The verbosity of the service logs. One of `trace`, `debug`, `info`, `warn` ,`error`, `fatal` or `silent`                                             | `info` (default)                                     |
| `OPENTELEMETRY_COLLECTOR_ENDPOINT`  | No       | OpenTelemetry Collector endpoint. The expected traces transport is HTTP (port `4318`).                                                               | `http://localhost:4318/v1/traces`                    |