Add monitored resource samples (GoogleCloudPlatform#797)

Author: bshaffer

monitoring/composer.json

@@ -19,8 +19,10 @@
             "src/delete_metric.php",
             "src/delete_uptime_check.php",
             "src/get_descriptor.php",
+            "src/get_resource.php",
             "src/get_uptime_check.php",
             "src/list_descriptors.php",
+            "src/list_resources.php",
             "src/list_uptime_check_ips.php",
             "src/list_uptime_checks.php",
             "src/read_timeseries_align.php",

monitoring/monitoring.php

@@ -88,6 +88,17 @@
         );
     });
 
+$application->add(new Command('get-resource'))
+    ->setDefinition(clone $inputDefinition)
+    ->addArgument('resource_type', InputArgument::REQUIRED, 'The monitored resource type')
+    ->setDescription('Gets a monitored resource.')
+    ->setCode(function ($input, $output) {
+        get_resource(
+            $input->getArgument('project_id'),
+            $input->getArgument('resource_type')
+        );
+    });
+
 $application->add(new Command('get-uptime-check'))
     ->setDefinition(clone $inputDefinition)
     ->addArgument('config_name', InputArgument::REQUIRED, 'The uptime check config name')
@@ -108,6 +119,15 @@
         );
     });
 
+$application->add(new Command('list-resources'))
+    ->setDefinition(clone $inputDefinition)
+    ->setDescription('List monitored resources.')
+    ->setCode(function ($input, $output) {
+        list_resources(
+            $input->getArgument('project_id')
+        );
+    });
+
 $application->add(new Command('list-uptime-check-ips'))
     ->setDefinition($inputDefinition)
     ->setDescription('Lists Uptime Check IPs.')

monitoring/src/get_resource.php

@@ -0,0 +1,59 @@
+<?php
+/**
+ * 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.
+ */
+
+/**
+ * For instructions on how to run the full sample:
+ *
+ * @see https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/monitoring/README.md
+ */
+
+namespace Google\Cloud\Samples\Monitoring;
+
+// [START monitoring_get_resource]
+use Google\Cloud\Monitoring\V3\MetricServiceClient;
+
+/**
+ * Example:
+ * ```
+ * get_resource('your-project-id', 'gcs_bucket');
+ * ```
+ *
+ * @param string $projectId Your project ID
+ * @param string $resourceType The resource type of the monitored resource.
+ */
+function get_resource($projectId, $resourceType)
+{
+    $metrics = new MetricServiceClient([
+        'projectId' => $projectId,
+    ]);
+
+    $metricName = $metrics->monitoredResourceDescriptorName($projectId, $resourceType);
+    $resource = $metrics->getMonitoredResourceDescriptor($metricName);
+
+    printf('Name: %s' . PHP_EOL, $resource->getName());
+    printf('Type: %s' . PHP_EOL, $resource->getType());
+    printf('Display Name: %s' . PHP_EOL, $resource->getDisplayName());
+    printf('Description: %s' . PHP_EOL, $resource->getDescription());
+    printf('Labels:' . PHP_EOL);
+    foreach ($resource->getLabels() as $labels) {
+        printf('  %s (%s) - %s' . PHP_EOL,
+            $labels->getKey(),
+            $labels->getValueType(),
+            $labels->getDescription());
+    }
+}
+// [END monitoring_get_resource]

monitoring/src/list_resources.php

@@ -0,0 +1,48 @@
+<?php
+/**
+ * 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.
+ */
+
+/**
+ * For instructions on how to run the full sample:
+ *
+ * @see https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/monitoring/README.md
+ */
+
+namespace Google\Cloud\Samples\Monitoring;
+
+// [START monitoring_list_resources]
+use Google\Cloud\Monitoring\V3\MetricServiceClient;
+
+/**
+ * Example:
+ * ```
+ * list_resources('your-project-id');
+ * ```
+ *
+ * @param string $projectId Your project ID
+ */
+function list_resources($projectId)
+{
+    $metrics = new MetricServiceClient([
+        'projectId' => $projectId,
+    ]);
+    $projectName = $metrics->projectName($projectId);
+    $descriptors = $metrics->listMonitoredResourceDescriptors($projectName);
+    foreach ($descriptors->iterateAllElements() as $descriptor) {
+        print($descriptor->getType() . PHP_EOL);
+    }
+}
+// [END monitoring_list_resources]

monitoring/test/monitoringTest.php

@@ -152,6 +152,23 @@ public function testDeleteMetric()
         }, self::RETRY_COUNT, true);
     }
 
+    public function testGetResource()
+    {
+        $output = $this->runCommand('get-resource', [
+            'project_id' => self::$projectId,
+            'resource_type' => 'gcs_bucket',
+        ]);
+        $this->assertContains('A Google Cloud Storage (GCS) bucket.', $output);
+    }
+
+    public function testListResources()
+    {
+        $output = $this->runCommand('list-resources', [
+            'project_id' => self::$projectId,
+        ]);
+        $this->assertContains('gcs_bucket', $output);
+    }
+
     public function testWriteTimeseries()
     {
         // Catch all exceptions as this method occasionally throws an Internal error.