Zum Hauptinhalt springen

Environment Variables

Environment variables for the userlog service

NameIntroduction VersionTypeDescriptionDefault Value
OC_TRACING_ENABLED
USERLOG_TRACING_ENABLED
1.0.0boolActivates tracing.false
OC_TRACING_TYPE
USERLOG_TRACING_TYPE
1.0.0stringThe type of tracing. Defaults to '', which is the same as 'jaeger'. Allowed tracing types are 'jaeger' and '' as of now.
OC_TRACING_ENDPOINT
USERLOG_TRACING_ENDPOINT
1.0.0stringThe endpoint of the tracing agent.
OC_TRACING_COLLECTOR
USERLOG_TRACING_COLLECTOR
1.0.0stringThe HTTP endpoint for sending spans directly to a collector, i.e. \http://jaeger-collector:14268/api/traces. Only used if the tracing endpoint is unset.
OC_LOG_LEVEL
USERLOG_LOG_LEVEL
1.0.0stringThe log level. Valid values are: 'panic', 'fatal', 'error', 'warn', 'info', 'debug', 'trace'.
OC_LOG_PRETTY
USERLOG_LOG_PRETTY
1.0.0boolActivates pretty log output.false
OC_LOG_COLOR
USERLOG_LOG_COLOR
1.0.0boolActivates colorized log output.false
OC_LOG_FILE
USERLOG_LOG_FILE
1.0.0stringThe path to the log file. Activates logging to this file if set.
USERLOG_DEBUG_ADDR1.0.0stringBind address of the debug server, where metrics, health, config and debug endpoints will be exposed.127.0.0.1:9214
USERLOG_DEBUG_TOKEN1.0.0stringToken to secure the metrics endpoint.
USERLOG_DEBUG_PPROF1.0.0boolEnables pprof, which can be used for profiling.false
USERLOG_DEBUG_ZPAGES1.0.0boolEnables zpages, which can be used for collecting and viewing in-memory traces.false
USERLOG_HTTP_ADDR1.0.0stringThe bind address of the HTTP service.127.0.0.1:9210
USERLOG_HTTP_ROOT1.0.0stringSubdirectory that serves as the root for this HTTP service./
OC_CORS_ALLOW_ORIGINS
USERLOG_CORS_ALLOW_ORIGINS
1.0.0[]stringA list of allowed CORS origins. See following chapter for more details: Access-Control-Allow-Origin at \https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin. See the Environment Variable Types description for more details.[*]
OC_CORS_ALLOW_METHODS
USERLOG_CORS_ALLOW_METHODS
1.0.0[]stringA list of allowed CORS methods. See following chapter for more details: Access-Control-Request-Method at \https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Request-Method. See the Environment Variable Types description for more details.[GET]
OC_CORS_ALLOW_HEADERS
USERLOG_CORS_ALLOW_HEADERS
1.0.0[]stringA list of allowed CORS headers. See following chapter for more details: Access-Control-Request-Headers at \https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Request-Headers. See the Environment Variable Types description for more details.[Authorization Origin Content-Type Accept X-Requested-With X-Request-Id Ocs-Apirequest]
OC_CORS_ALLOW_CREDENTIALS
USERLOG_CORS_ALLOW_CREDENTIALS
1.0.0boolAllow credentials for CORS.See following chapter for more details: Access-Control-Allow-Credentials at \https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Credentials.true
OC_HTTP_TLS_ENABLED1.0.0boolActivates TLS for the http based services using the server certifcate and key configured via OC_HTTP_TLS_CERTIFICATE and OC_HTTP_TLS_KEY. If OC_HTTP_TLS_CERTIFICATE is not set a temporary server certificate is generated - to be used with PROXY_INSECURE_BACKEND=true.false
OC_HTTP_TLS_CERTIFICATE1.0.0stringPath/File name of the TLS server certificate (in PEM format) for the http services.
OC_HTTP_TLS_KEY1.0.0stringPath/File name for the TLS certificate key (in PEM format) for the server certificate to use for the http services.
OC_JWT_SECRET
USERLOG_JWT_SECRET
1.0.0stringThe secret to mint and validate jwt tokens.
OC_REVA_GATEWAY1.0.0stringCS3 gateway used to look up user metadataeu.opencloud.api.gateway
OC_TRANSLATION_PATH
USERLOG_TRANSLATION_PATH
1.0.0string(optional) Set this to a path with custom translations to overwrite the builtin translations. Note that file and folder naming rules apply, see the documentation for more details.
OC_DEFAULT_LANGUAGE1.0.0stringThe default language used by services and the WebUI. If not defined, English will be used as default. See the documentation for more details.
OC_EVENTS_ENDPOINT
USERLOG_EVENTS_ENDPOINT
1.0.0stringThe address of the event system. The event system is the message queuing service. It is used as message broker for the microservice architecture.127.0.0.1:9233
OC_EVENTS_CLUSTER
USERLOG_EVENTS_CLUSTER
1.0.0stringThe clusterID of the event system. The event system is the message queuing service. It is used as message broker for the microservice architecture. Mandatory when using NATS as event system.opencloud-cluster
OC_INSECURE
USERLOG_EVENTS_TLS_INSECURE
1.0.0boolWhether to verify the server TLS certificates.false
OC_EVENTS_TLS_ROOT_CA_CERTIFICATE
USERLOG_EVENTS_TLS_ROOT_CA_CERTIFICATE
1.0.0stringThe root CA certificate used to validate the server's TLS certificate. If provided NOTIFICATIONS_EVENTS_TLS_INSECURE will be seen as false.
OC_EVENTS_ENABLE_TLS
USERLOG_EVENTS_ENABLE_TLS
1.0.0boolEnable TLS for the connection to the events broker. The events broker is the OpenCloud service which receives and delivers events between the services.false
OC_EVENTS_AUTH_USERNAME
USERLOG_EVENTS_AUTH_USERNAME
1.0.0stringThe username to authenticate with the events broker. The events broker is the OpenCloud service which receives and delivers events between the services.
OC_EVENTS_AUTH_PASSWORD
USERLOG_EVENTS_AUTH_PASSWORD
1.0.0stringThe password to authenticate with the events broker. The events broker is the OpenCloud service which receives and delivers events between the services.
OC_MAX_CONCURRENCY
USERLOG_MAX_CONCURRENCY
1.0.0intMaximum number of concurrent go-routines. Higher values can potentially get work done faster but will also cause more load on the system. Values of 0 or below will be ignored and the default value will be used.1
OC_PERSISTENT_STORE
USERLOG_STORE
1.0.0stringThe type of the store. Supported values are: 'memory', 'nats-js-kv', 'redis-sentinel', 'noop'. See the text description for details.memory
OC_PERSISTENT_STORE_NODES
USERLOG_STORE_NODES
1.0.0[]stringA list of nodes to access the configured store. This has no effect when 'memory' store is configured. Note that the behaviour how nodes are used is dependent on the library of the configured store. See the Environment Variable Types description for more details.[]
USERLOG_STORE_DATABASE1.0.0stringThe database name the configured store should use.userlog
USERLOG_STORE_TABLE1.0.0stringThe database table the store should use.events
OC_PERSISTENT_STORE_TTL
USERLOG_STORE_TTL
1.0.0DurationTime to live for events in the store. Defaults to '336h' (2 weeks). See the Environment Variable Types description for more details.336h0m0s
OC_PERSISTENT_STORE_AUTH_USERNAME
USERLOG_STORE_AUTH_USERNAME
1.0.0stringThe username to authenticate with the store. Only applies when store type 'nats-js-kv' is configured.
OC_PERSISTENT_STORE_AUTH_PASSWORD
USERLOG_STORE_AUTH_PASSWORD
1.0.0stringThe password to authenticate with the store. Only applies when store type 'nats-js-kv' is configured.
OC_DISABLE_SSE,USERLOG_DISABLE_SSE1.0.0boolDisables server-sent events (sse). When disabled, clients will no longer receive sse notifications.false
USERLOG_GLOBAL_NOTIFICATIONS_SECRET1.0.0stringThe secret to secure the global notifications endpoint. Only system admins and users knowing that secret can call the global notifications POST/DELETE endpoints.
OC_SERVICE_ACCOUNT_ID
USERLOG_SERVICE_ACCOUNT_ID
1.0.0stringThe ID of the service account the service should use. See the 'auth-service' service description for more details.
OC_SERVICE_ACCOUNT_SECRET
USERLOG_SERVICE_ACCOUNT_SECRET
1.0.0stringThe service account secret.