[skip ci] Publish documentation v1.6

inspectit-ocelot-documentation/website/versioned_docs/version-1.6/breaking-changes/1.6.md

@@ -0,0 +1,7 @@
+---
+id: version-1.6-1-6
+title: Breaking changes in 1.6
+original_id: 1-6
+---
+
+There are no breaking changes for version 1.6.

inspectit-ocelot-documentation/website/versioned_docs/version-1.6/configuration/configuration-sources.md

@@ -0,0 +1,97 @@
+---
+id: version-1.6-configuration-sources
+title: Configuration Sources
+original_id: configuration-sources
+---
+
+inspectIT Ocelot tries to implement the zero-configuration approach but lets you externalize the configuration and influence every bit of its configuration if this is required.
+Internally it uses the Spring-based `PropertySource` order to allow overriding of configuration values.
+Configuration properties are considered in inspectIT Ocelot in the following order:
+
+1. [Java Agent Arguments](#java-agent-arguments)
+1. [Java System Properties](#java-system-properties)
+1. [OS environment Variables](#os-environment-variables)
+1. External Configuration Sources:
+    * [File-based Configuration](configuration/external-configuration-sources.md#file-based-configuration)
+1. inspectIT Ocelot Defaults
+
+When an invalid configuration is given to inspectIT on startup, the agent will use a fallback configuration.
+In this fallback configuration, the agent is inactive with the exception of listening for configuration updates.
+
+When giving an invalid configuration through a runtime update to the agent, the agent will simply retain the previous configuration.
+
+## Available Configuration Sources
+
+### Java Agent Arguments
+
+You can pass a JSON object as string to the agent via its command line arguments.
+For example, to override the service name used to identify your application reporting the performance data,
+you can change the `inspectit.service-name` property as follows:
+
+```bash
+$ java -javaagent:/path/to/inspectit-ocelot-agent-1.6.jar="{ \"inspectit\": { \"service-name\": \"My Custom Service\" }}" -jar my-java-program.jar
+```
+
+Note that you have to escape the quotes within your JSON string. On linux you can just use the more readable single quotes notation:
+
+```bash
+$ java -javaagent:/path/to/inspectit-ocelot-agent-1.6.jar='{ "inspectit": { "service-name": "My Custom Service" }}' -jar my-java-program.jar
+```
+
+### Java System Properties
+
+You can pass any configuration property as the Java System property to the Java command that you use to start your Java application.
+Using this approach you can change the `inspectit.service-name` property as follows:
+
+```bash
+$ java -Dinspectit.service-name="My Custom Service" -javaagent:/path/to/inspectit-ocelot-agent-1.6.jar -jar my-java-program.jar
+```
+
+### OS Environment Variables
+
+Similar to the Java System properties, inspectIT Ocelot will also consider all the available operating system environment variables.
+Due to the relaxed bindings, you can use upper case format, which is recommended when using system environment variables.
+
+```bash
+$ INSPECTIT_SERVICE_NAME="My Custom Service" java -javaagent:/path/to/inspectit-ocelot-agent-1.6.jar -jar my-java-program.jar
+```
+
+## Relaxed Bindings
+
+Note that due to the Spring-powered configuration approach, the inspectIT Ocelot agent uses Spring support for relaxed bindings.
+This means that a property can be specified in different formats depending on the property source.
+As suggested by Spring, the allowed formats are:
+
+| Property | Note |
+| --- | --- |
+| `inspectit.service-name` | Kebab-case, which is recommended for use in `.properties` and `.yml` files. |
+| `inspectit.serviceName` | Standard camelCase syntax. |
+| `inspectit.service_name` | Underscore notation (snake_case), which is an alternative format for use in `.properties` and `.yml` files. |
+| `INSPECTIT_SERVICE_NAME` | UPPER_CASE format, which is recommended when using system environment variables. |
+
+The formats should be used in the following way, based on the type of property source:
+
+| Property Source | Format |
+| --- | --- |
+| System properties | Camel case, kebab case, or underscore notation. |
+| Environment Variables | Upper case format with the underscore as the delimiter. |
+| Property files (`.properties`) | Camel case, kebab case, or underscore notation. |
+| YAML files (`.yaml`, `.yml`) | Camel case, kebab case, or underscore notation. |
+
+## Environment Information
+
+Each agent stores the following information about its runtime environment: 
+
+| Property | Note |
+| --- | --- |
+| `inspectit.env.agent-dir` | Resolves to the path where the agent-jar is stored. |
+| `inspectit.env.hostname` | The hostname where the agent is running. |
+| `inspectit.env.pid` | The process id of the JVM process. |
+
+They are used to define the default behavior when writing the configuration persistence file and will be sent
+as attributes to the configuration server when fetching the configuration.
+
+You can reference these properties within the configuration using e.g. `${inspectit.env.agent-dir}` 
+as shown in the default configuration for 
+[HTTP-based configuration](configuration/external-configuration-sources.md#http-based-configuration).
+Referencing every other property follows the same schema.

inspectit-ocelot-documentation/website/versioned_docs/version-1.6/configuration/open-census-configuration.md

@@ -0,0 +1,35 @@
+---
+id: version-1.6-open-census-configuration
+title: Using OpenCensus Library with inspectIT Ocelot
+sidebar_label: OpenCensus Configuration
+original_id: open-census-configuration
+---
+
+If you plan to use the OpenCensus library in an application which will be instrumented later on with inspectIT Ocelot, some special rules do apply.
+Following these rules will make sure that there are no run-time problems in your application.
+Furthermore, a correct configuration will make it possible to combine metrics and traces that you manually collect using the OpenCensus instrumentation library with the ones collected by the inspectIT Ocelot agent.
+
+1. Make sure you are using the same version of OpenCensus as inspectIT Ocelot.
+
+   The inspectIT Ocelot agent in version 1.6 internally uses OpenCensus in version 0.22.1.ocelot.1. Please adapt any OpenCensus dependency in your application to this version to avoid run-time conflicts.
+   ```XML
+   <dependency>
+       <groupId>io.opencensus</groupId>
+       <artifactId>opencensus-api</artifactId>
+       <version>0.22.1.ocelot.1</version>
+   </dependency>
+   ```
+
+2. Set the JVM property `inspectit.publishOpenCensusToBootstrap` to `true`.
+
+   ```
+   -Dinspectit.publishOpenCensusToBootstrap=true
+   ```
+
+   Setting the above property to `true` tells inspectIT Ocelot that you plan to use the OpenCensus library in combination with the agent. Note that this property must be specified with this exact name. The flexibility offered for all other config options does not apply here. The inspectIT Ocelot agent will make sure that all OpenCensus classes are then loaded by the bootstrap class loader. This ensures that OpenCensus implementation is shared between your manual instrumentation and the agent instrumentation, making the combination of data possible.
+
+3. Add the agent to the start of a JVM
+
+   In this scenario, it is required that you add the agent via [the `javaagent` JVM argument](getting-started/installation.md#adding-the-agent-to-a-jvm). If the agent is successfully added to the JVM, it will log that the OpenCensus classes pushed to the bootstrap classloader will be used.
+
+   It is important to state that the agent will *not* publish the OpenCensus classes to the bootstrap classloader if it is attached during runtime – even if the previously mentioned JVM argument is set! In this case, metrics and traces of *manual OpenCensus instrumentations* will *not* be collected by the inspectIT Ocelot agent.