An HTTP service for the controlling of data and rendering templates relevant to a particular dataset.
| Environment variable | Default | Description |
|---|---|---|
| API_ROUTER_URL | http://localhost:23200/v1 | The URL of the dp-api-router |
| BIND_ADDR | :20200 | The host and port to bind to. |
| CACHE_NAVIGATION_UPDATE_INTERVAL | 10s | How often the navigation cache is updated |
| DEBUG | false | Enable debug mode |
| DOWNLOAD_SERVICE_URL | http://localhost:23600 | The URL of dp-download-service. |
| ENABLE_FEEDBACK_API | false | Enable feedback api |
| ENABLE_MULTIVARIATE | false | Enable 2021 multivariate datasets |
| ENABLE_NEW_NAV_BAR | false | Enable new nav bar |
| ENABLE_PROFILER | false | Flag to enable go profiler |
| FEEDBACK_API_URL | http://localhost:23200/v1/feedback | The public dp-api-router address for feedback, not the internal one |
| GRACEFUL_SHUTDOWN_TIMEOUT | 5s | The graceful shutdown timeout in seconds |
| HEALTHCHECK_CRITICAL_TIMEOUT | 90s | The time taken for the health changes from warning state to critical due to subsystem check failures |
| HEALTHCHECK_INTERVAL | 30s | The time between calling healthcheck endpoints for check subsystems |
| OTEL_BATCH_TIMEOUT | 5s | Interval between pushes to OT Collector |
| OTEL_EXPORTER_OTLP_ENDPOINT | http://localhost:4317 | URL for OpenTelemetry endpoint |
| OTEL_SERVICE_NAME | "dp-frontend-dataset-controller" | Service name to report to telemetry tools |
| OTEL_ENABLED | false | Feature flag to enable OpenTelemetry |
| PATTERN_LIBRARY_ASSETS_PATH | "" | Pattern library location |
| PPROF_TOKEN | "" | The profiling token to access service profiling |
| SITE_DOMAIN | localhost | |
| SUPPORTED_LANGUAGES | []string{"en", "cy"} | Supported languages |
An optional /debug endpoint has been added, in order to profile this service via pprof go library.
In order to use this endpoint, you will need to enable profiler flag and set a PPROF_TOKEN:
export ENABLE_PROFILER=true
export PPROF_TOKEN={generated uuid}
Then you can us the profiler as follows:
1- Start service, load test or if on environment wait for a number of requests to be made.
2- Send authenticated request and store response in a file (this can be best done in command line like so: curl <host>:<port>/debug/pprof/heap -H "Authorization: Bearer {generated uuid} > heap.out - see pprof documentation on other endpoints
3- View profile either using a web ui to navigate data (a) or using pprof on command line to navigate data (b)
a) go tool pprof -http=:8080 heap.out
b) go tool pprof heap.out, -o flag to see various options
Copyright © 2025, Office for National Statistics (https://www.ons.gov.uk)
Released under MIT license, see LICENSE for details.
