WebHost
PiBox.Hosting.WebHost is the core package
that allows dotnet dev's
to use the pibox web host and pibox plugins
.
This package is mandatory, without it you can't use any plugins
Installation
To install the nuget package follow these steps:
or add as package reference to your .csproj
Rewrite the Entrypoint Program.cs to have following code:
Config files and ENV vars
PiBox will try to load config files and values in the following order
appsettings.json
appsettings.yaml
appsettings.yml
appsettings.*.json
appsettings.*.yaml
appsettings.*.yml
appsettings.secrets.yml
appsettings.*.secrets.yml
9ENV variables
NOTE: All settings (does not matter which file extension) will be ordered by node length. And the secret files will be loaded as last (except the environment variables).
Example:
appsettings.yaml
appsettings.api.yaml
appsettings.api.host.yaml
appsettings.secrets.yaml
apssettings.api.secrets.yaml
appsettings.api.host.secrets.yaml
ENV Variables
File names must always start with appsettings
or they will be ignored!
Nested settings use _
to build their hierarchy as ENV variables
becomes
General settings
Configure your config file with these properties
or as ENV variables
Logging
Configure your appsettings.logging.yml with these properties
or as ENV variables
Usage
Rewrite your entrypoint Program.cs to have following code:
Now you can add additional plugins as nuget packages to your project and configure them via config files/settings and/or in your web host plugin
Metrics
Pibox uses open telemetry for it's metrics capabilities. Further info can be found here
Tracing settings
Pibox uses open telemetry for it's tracing capabilities. Further info can be found here
https://opentelemetry.io/docs/instrumentation/net/getting-started/
If there is a tracing host configured, the service will try to send any traces to this host. it will also enrich the log messages with SpanIds and TraceIds.
Last updated