Added application insights starter for spring boot

azure-application-insights-spring-boot-starter/README.md

@@ -0,0 +1,140 @@
+
+**Application Insights Spring Boot Starter**
+
+This Starter provides you the minimal and required configuration to use Application Insights in your Spring Boot application.
+
+**Requirements**
+Spring Boot 1.5+ or 2.0+
+
+**Quick Start**
+
+*1. Add dependency*
+Gradle:
+```groovy
+compile "com.microsoft.azure:azure-application-insights-spring-boot-starter:${version}"
+```
+
+Maven:
+```xml
+<dependency>
+  <groupId>com.microsoft.azure</groupId>
+  <artifactId>azure-application-insights-spring-boot-starter</artifactId>
+  <version>${version}</version>
+</dependency>
+```
+
+*2. Provide Instrumentation Key*
+
+Add property
+```
+azure.application-insights.instrumentation-key=<key from the Azure Portal>
+```
+into your `application.properties`
+
+*3. Run your application*
+
+Start your spring boot application as usual and in few minutes you'll start getting events.
+
+**Additional Configuration**
+
+#### Sending custom telemetry
+```java
+@RestController
+public class TelemetryController {
+
+    @Autowired
+    private TelemetryClient telemetryClient;
+
+    @RequestMapping("/telemetry")
+    public void telemetry() {
+        telemetryClient.trackEvent("my event");
+    }
+}
+```
+
+
+#### Sending logs to the application insight
+
+Follow the instructions from [Spring Boot logging documentation](https://docs.spring.io/spring-boot/docs/current/reference/html/howto-logging.html) to configure custom logback or log4j2 appender.
+
+`logback-spring.xml`:
+```xml
+<appender name="aiAppender"
+  class="com.microsoft.applicationinsights.logback.ApplicationInsightsAppender">
+</appender>
+<root level="trace">
+  <appender-ref ref="aiAppender" />
+</root>
+```
+
+`log4j2.xml`:
+```xml
+<Configuration packages="com.microsoft.applicationinsights.log4j.v2">
+  <Appenders>
+    <ApplicationInsightsAppender name="aiAppender" />
+  </Appenders>
+  <Loggers>
+    <Root level="trace">
+      <AppenderRef ref="aiAppender"/>
+    </Root>
+  </Loggers>
+</Configuration>
+```
+
+#### Register own telemetry module, processor or initializer by defining it as a bean in the configuration
+```java
+@SpringBootApplication
+public class MyApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(MyApplication.class, args);
+    }
+
+    @Bean
+    public TelemetryModule myTelemetryModule() {
+        return new MyTelemetryModule();
+    }
+
+    @Bean
+    public TelemetryInitializer myTelemetryInitializer() {
+        return new MyTelemetryInitializer();
+    }
+
+    @Bean
+    public TelemetryProcessor myTelemetryProcessor() {
+        return new MyTelemetryProcessor();
+    }
+
+    @Bean
+    public ContextInitializer myContextInitializer() {
+        return new MyContextInitializer();
+    }
+}
+```
+
+
+#### Configure more parameters using `application.properties`
+```properties
+# Enable/Disable tracking
+azure.application-insights.enabled=true
+
+# Instrumentation key from the Azure Portal
+azure.application-insights.instrumentation-key=00000000-0000-0000-0000-000000000000
+
+# Logging type [console, file]
+azure.application-insights.logger.type=console
+# Logging level [all, trace, info, warn, error, off]
+azure.application-insights.logger.level=info
+
+# Enable/Disable default telemetry modules
+azure.application-insights.default-modules.ProcessPerformanceCountersModule.enabled=true
+azure.application-insights.default-modules.WebRequestTrackingTelemetryModule.enabled=true
+azure.application-insights.default-modules.WebSessionTrackingTelemetryModule.enabled=true
+azure.application-insights.default-modules.WebUserTrackingTelemetryModule.enabled=true
+azure.application-insights.default-modules.WebPerformanceCounterModule.enabled=true
+azure.application-insights.default-modules.WebOperationIdTelemetryInitializer.enabled=true
+azure.application-insights.default-modules.WebOperationNameTelemetryInitializer.enabled=true
+azure.application-insights.default-modules.WebSessionTelemetryInitializer.enabled=true
+azure.application-insights.default-modules.WebUserTelemetryInitializer.enabled=true
+azure.application-insights.default-modules.WebUserAgentTelemetryInitializer.enabled=true
+```

azure-application-insights-spring-boot-starter/build.gradle

@@ -0,0 +1,51 @@
+/*
+ * ApplicationInsights-Java
+ * Copyright (c) Microsoft Corporation
+ * All rights reserved.
+ *
+ * MIT License
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the ""Software""), to deal in the Software
+ * without restriction, including without limitation the rights to use, copy, modify, merge,
+ * publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+ * persons to whom the Software is furnished to do so, subject to the following conditions:
+ * The above copyright notice and this permission notice shall be included in all copies or
+ * substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ * PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+ * FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ */
+
+apply from: "$buildScriptsDir/common-java.gradle"
+apply from: "$buildScriptsDir/publishing.gradle"
+
+archivesBaseName = 'azure-application-insights-spring-boot-starter'
+
+dependencies {
+    compile (project(':core'))
+    compile (project(':web'))
+    provided('org.springframework.boot:spring-boot:1.5.9.RELEASE')
+    provided('org.springframework.boot:spring-boot-autoconfigure:1.5.9.RELEASE')
+    provided('org.springframework.boot:spring-boot-starter-web:1.5.9.RELEASE')
+    provided('org.springframework.boot:spring-boot-configuration-processor:1.5.9.RELEASE')
+
+    testCompile('org.junit.jupiter:junit-jupiter-api:5.0.2')
+    testCompile('org.junit.jupiter:junit-jupiter-params:5.0.2')
+    testCompile('org.junit.jupiter:junit-jupiter-engine:5.0.2')
+    testCompile('org.springframework.boot:spring-boot-starter-test:1.5.9.RELEASE')
+    testCompile('org.assertj:assertj-core:3.9.0')
+}
+
+// region Publishing properties
+
+projectPomName = project.msftAppInsightsJavaSdk + " Spring Boot starter"
+projectPomDescription = "This is the Spring Boot starter of " + project.msftAppInsightsJavaSdk
+
+whenPomConfigured = { p ->
+    def agentArtifactId = project(":agent").jar.baseName
+    p.dependencies = p.dependencies.findAll { dep -> dep.artifactId != agentArtifactId }
+    writePomToArtifactsDirectory(p, project.name)
+}

azure-application-insights-spring-boot-starter/src/main/java/com/microsoft/applicationinsights/boot/ApplicationInsightsModuleConfiguration.java

@@ -0,0 +1,72 @@
+/*
+ * ApplicationInsights-Java
+ * Copyright (c) Microsoft Corporation
+ * All rights reserved.
+ *
+ * MIT License
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the ""Software""), to deal in the Software
+ * without restriction, including without limitation the rights to use, copy, modify, merge,
+ * publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+ * persons to whom the Software is furnished to do so, subject to the following conditions:
+ * The above copyright notice and this permission notice shall be included in all copies or
+ * substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ * PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+ * FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ */
+
+package com.microsoft.applicationinsights.boot;
+
+import com.microsoft.applicationinsights.TelemetryConfiguration;
+import com.microsoft.applicationinsights.boot.conditional.ConditionalOnOperatingSystem;
+import com.microsoft.applicationinsights.boot.conditional.OperatingSystem;
+import com.microsoft.applicationinsights.boot.initializer.SpringBootContextInitializer;
+import com.microsoft.applicationinsights.extensibility.initializer.DeviceInfoContextInitializer;
+import com.microsoft.applicationinsights.extensibility.initializer.SdkVersionContextInitializer;
+import com.microsoft.applicationinsights.internal.perfcounter.ProcessPerformanceCountersModule;
+import org.springframework.boot.autoconfigure.condition.ConditionalOnBean;
+import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.core.env.Environment;
+
+/**
+ * {@link Configuration} for non-web applications.
+ *
+ * @author Arthur Gavlyukovskiy
+ */
+@Configuration
+@ConditionalOnBean(TelemetryConfiguration.class)
+public class ApplicationInsightsModuleConfiguration {
+
+    @Bean
+    public SpringBootContextInitializer springBootContextInitializer(Environment environment) {
+        return new SpringBootContextInitializer(environment);
+    }
+
+    @Bean
+    public SdkVersionContextInitializer sdkVersionContextInitializer() {
+        return new SdkVersionContextInitializer();
+    }
+
+    @Bean
+    public DeviceInfoContextInitializer deviceInfoContextInitializer() {
+        return new DeviceInfoContextInitializer();
+    }
+
+    @Bean
+    @ConditionalOnOperatingSystem(OperatingSystem.WINDOWS)
+    @ConditionalOnProperty(value = "azure.application-insights.default-modules.ProcessPerformanceCountersModule.enabled", havingValue = "true", matchIfMissing = true)
+    public ProcessPerformanceCountersModule processPerformanceCountersModule() {
+        try {
+            return new ProcessPerformanceCountersModule();
+        }
+        catch (Exception e) {
+            throw new IllegalStateException("Could not initialize Windows performance counters module", e);
+        }
+    }
+}

azure-application-insights-spring-boot-starter/src/main/java/com/microsoft/applicationinsights/boot/ApplicationInsightsProperties.java

@@ -0,0 +1,103 @@
+/*
+ * ApplicationInsights-Java
+ * Copyright (c) Microsoft Corporation
+ * All rights reserved.
+ *
+ * MIT License
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the ""Software""), to deal in the Software
+ * without restriction, including without limitation the rights to use, copy, modify, merge,
+ * publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+ * persons to whom the Software is furnished to do so, subject to the following conditions:
+ * The above copyright notice and this permission notice shall be included in all copies or
+ * substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ * PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+ * FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ */
+
+package com.microsoft.applicationinsights.boot;
+
+import com.microsoft.applicationinsights.extensibility.TelemetryModule;
+import com.microsoft.applicationinsights.internal.logger.InternalLogger.LoggerOutputType;
+import com.microsoft.applicationinsights.internal.logger.InternalLogger.LoggingLevel;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * {@link ConfigurationProperties} for configuring application insights.
+ *
+ * @author Arthur Gavlyukovskiy
+ */
+@ConfigurationProperties("azure.application-insights")
+public class ApplicationInsightsProperties {
+
+    /**
+     * Enables application insights auto-configuration.
+     */
+    private boolean enabled = true;
+    /**
+     * Instrumentation key from Azure Portal.
+     */
+    private String instrumentationKey;
+    /**
+     * Logger properties.
+     */
+    private Logger logger = new Logger();
+
+    public boolean isEnabled() {
+        return enabled;
+    }
+
+    public void setEnabled(boolean enabled) {
+        this.enabled = enabled;
+    }
+
+    public String getInstrumentationKey() {
+        return instrumentationKey;
+    }
+
+    public void setInstrumentationKey(String instrumentationKey) {
+        this.instrumentationKey = instrumentationKey;
+    }
+
+    public Logger getLogger() {
+        return logger;
+    }
+
+    public void setLogger(Logger logger) {
+        this.logger = logger;
+    }
+
+    public static class Logger {
+        /**
+         * Type of application insights logger.
+         */
+        private LoggerOutputType type = LoggerOutputType.CONSOLE;
+        /**
+         * Minimal level of application insights logger.
+         */
+        private LoggingLevel level = LoggingLevel.INFO;
+
+        public LoggerOutputType getType() {
+            return type;
+        }
+
+        public void setType(LoggerOutputType type) {
+            this.type = type;
+        }
+
+        public LoggingLevel getLevel() {
+            return level;
+        }
+
+        public void setLevel(LoggingLevel level) {
+            this.level = level;
+        }
+    }
+}