console/packages/services/usage/README.md
Laurin Quast 8c3413a207
feat(usage): report with organization access tokens (#6538)
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
2025-03-06 09:19:37 +08:00

9.5 KiB

@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