console/packages/services/usage
2026-03-06 22:37:08 +01:00
..
__tests__ fix: improve errors for usage processor 2 format (#6472) 2025-02-05 13:04:35 +01:00
src fix: sentry graphql api (#7660) 2026-02-11 17:17:56 +01:00
.env.template feat(usage): report with organization access tokens (#6538) 2025-03-06 09:19:37 +08:00
.gitignore Hello 2022-05-18 09:26:57 +02:00
LICENSE chore: update year in LICENSEs (#53) 2022-05-23 23:10:27 +02:00
package.json chore: fix vulnerability dependencies (#7715) 2026-02-20 15:52:35 +01:00
README.md feat(usage): report with organization access tokens (#6538) 2025-03-06 09:19:37 +08:00
tsconfig.json Enhancement/hive lab lib (#7697) 2026-03-06 22:37:08 +01:00
turbo.json chore: add dev:hive script using turbo (#7053) 2025-09-26 20:21:17 +09:00
usage-report-v2.schema.json enhance(sdk-rs): use usage report json schema as a source of truth (#7405) 2025-12-11 11:55:55 +00:00

@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 for more information ./path_to_ca
KAFKA_SSL_CERT_PATH No Refer to TLS create secure context for more information ./path_to_cert
KAFKA_SSL_KEY_PATH No Refer to TLS create secure context 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