Adding BigQuery + StackDriver Monitoring API Showcase sample.

Author: dzlier-gcp

bigquery/cloud-client/README.md

@@ -46,3 +46,45 @@ documentation](https://cloud.google.com/bigquery/create-simple-app-api):
 
     mvn exec:java -Dexec.mainClass=com.example.bigquery.SimpleApp
 
+## BigQuery + Logging SimpleApp
+
+This API Showcase demonstrates how to run a BigQuery query and then log some metrics to StackDriver Monitoring
+from the results, including the query runtime and number of rows returned.
+
+### Clone the sample app
+
+Copy the sample apps to your local machine, and cd to the bigquery/cloud-client directory:
+
+```
+git clone https://github.com/GoogleCloudPlatform/java-docs-samples
+cd java-docs-samples/bigquery/cloud-client
+```
+
+### Setup
+
+- Make sure [`gcloud`](https://cloud.google.com/sdk/docs/) is installed and initialized:
+```
+   gcloud init
+```
+- If this is the first time you are creating an App Engine project
+```
+   gcloud app create
+```
+- For local development, [set up][set-up] authentication
+- Enable [BigQuery][bigquery-api] and [Monitoring][monitoring-api] APIs
+- If you have not already enabled your project for StackDriver, do so by following [these instructions][stackdriver-setup].
+  
+[set-up]: https://cloud.google.com/docs/authentication/getting-started
+[bigquery-api]: https://console.cloud.google.com/launcher/details/google/bigquery-json.googleapis.com
+[monitoring-api]: https://console.cloud.google.com/launcher/details/google/monitoring.googleapis.com
+[stackdriver-setup]: https://cloud.google.com/monitoring/accounts/tiers#not-enabled
+
+### Run the SimpleApp
+
+Build your project with:
+
+	mvn clean package -DskipTests
+	
+Provide the projectId as a system variable when running the sample.
+
+    mvn exec:java -Dexec.mainClass=com.example.bigquery_logging.SimpleApp -DprojectId=<your-project-id>

bigquery/cloud-client/pom.xml

@@ -30,8 +30,8 @@
   </parent>
 
   <properties>
-    <maven.compiler.target>1.7</maven.compiler.target>
-    <maven.compiler.source>1.7</maven.compiler.source>
+    <maven.compiler.target>1.8</maven.compiler.target>
+    <maven.compiler.source>1.8</maven.compiler.source>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   </properties>
 
@@ -43,6 +43,15 @@
       <version>0.33.0-beta</version>
     </dependency>
     <!-- [END dependencies] -->
+
+    <!-- [START monitoring_dependencies ] -->
+    <dependency>
+      <groupId>com.google.cloud</groupId>
+      <artifactId>google-cloud-monitoring</artifactId>
+      <version>0.33.0-beta</version>
+    </dependency>
+    <!-- [END monitoring_dependencies ] -->
+
     <dependency>
       <groupId>commons-cli</groupId>
       <artifactId>commons-cli</artifactId>
@@ -67,5 +76,11 @@
       <version>0.39</version>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <version>2.13.0</version>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
 </project>

bigquery/cloud-client/src/main/java/com/example/bigquery_logging/RequiredMetric.java

@@ -0,0 +1,86 @@
+/*
+ * Copyright 2018 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.bigquery_logging;
+
+import com.google.api.MetricDescriptor;
+
+import java.util.Objects;
+
+public class RequiredMetric {
+  private String shortName;
+  private String name;
+  private String description;
+  private MetricDescriptor.MetricKind metricKind;
+  private MetricDescriptor.ValueType valueType;
+
+  public RequiredMetric(String shortName, String description) {
+    this.shortName = shortName;
+    this.name = "custom.googleapis.com/" + shortName;
+    this.description = description;
+    this.metricKind = MetricDescriptor.MetricKind.GAUGE;
+    this.valueType = MetricDescriptor.ValueType.INT64;
+  }
+
+  public RequiredMetric(String shortName,
+                        String name,
+                        String description,
+                        MetricDescriptor.MetricKind metricKind,
+                        MetricDescriptor.ValueType valueType) {
+    this.shortName = shortName;
+    this.name = name;
+    this.description = description;
+    this.metricKind = metricKind;
+    this.valueType = valueType;
+  }
+
+  public String getShortName() {
+    return shortName;
+  }
+
+  public String getName() {
+    return name;
+  }
+
+  public String getDescription() {
+    return description;
+  }
+
+  public MetricDescriptor.MetricKind getMetricKind() {
+    return metricKind;
+  }
+
+  public MetricDescriptor.ValueType getValueType() {
+    return valueType;
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) return true;
+    if (o == null || getClass() != o.getClass()) return false;
+    RequiredMetric that = (RequiredMetric) o;
+    return Objects.equals(name, that.name) &&
+        metricKind == that.metricKind &&
+        valueType == that.valueType;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(name, metricKind, valueType);
+  }
+
+
+}