Stackdriver Monitoring V3 Client - Class MetricServiceClient (1.6.0)

use Google\ApiCore\ApiException;
use Google\Api\MetricDescriptor;
use Google\Cloud\Monitoring\V3\MetricServiceClient;

/**
 * @param string $name The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
 *                     which to execute the request. The format is:
 *                     4
 *                     projects/[PROJECT_ID_OR_NUMBER]
 */
function create_metric_descriptor_sample(string $name): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $metricDescriptor = new MetricDescriptor();

    // Call the API and handle any network failures.
    try {
        /** @var MetricDescriptor $response */
        $response = $metricServiceClient->createMetricDescriptor($name, $metricDescriptor);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $name = '[NAME]';

    create_metric_descriptor_sample($name);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Monitoring\V3\MetricServiceClient;
use Google\Cloud\Monitoring\V3\TimeSeries;

/**
 * @param string $formattedName The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
 *                              which to execute the request. The format is:
 *
 *                              projects/[PROJECT_ID_OR_NUMBER]
 *                              Please see {@see MetricServiceClient::projectName()} for help formatting this field.
 */
function create_service_time_series_sample(string $formattedName): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $timeSeries = [new TimeSeries()];

    // Call the API and handle any network failures.
    try {
        $metricServiceClient->createServiceTimeSeries($formattedName, $timeSeries);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = MetricServiceClient::projectName('[PROJECT]');

    create_service_time_series_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Monitoring\V3\MetricServiceClient;
use Google\Cloud\Monitoring\V3\TimeSeries;

/**
 * @param string $formattedName The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
 *                              which to execute the request. The format is:
 *
 *                              projects/[PROJECT_ID_OR_NUMBER]
 *                              Please see {@see MetricServiceClient::projectName()} for help formatting this field.
 */
function create_time_series_sample(string $formattedName): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $timeSeries = [new TimeSeries()];

    // Call the API and handle any network failures.
    try {
        $metricServiceClient->createTimeSeries($formattedName, $timeSeries);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = MetricServiceClient::projectName('[PROJECT]');

    create_time_series_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Monitoring\V3\MetricServiceClient;

/**
 * @param string $formattedName The metric descriptor on which to execute the request. The format is:
 *
 *                              projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
 *
 *                              An example of `[METRIC_ID]` is:
 *                              `"custom.googleapis.com/my_test_metric"`. Please see
 *                              {@see MetricServiceClient::metricDescriptorName()} for help formatting this field.
 */
function delete_metric_descriptor_sample(string $formattedName): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Call the API and handle any network failures.
    try {
        $metricServiceClient->deleteMetricDescriptor($formattedName);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = MetricServiceClient::metricDescriptorName('[PROJECT]', '[METRIC_DESCRIPTOR]');

    delete_metric_descriptor_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Api\MetricDescriptor;
use Google\Cloud\Monitoring\V3\MetricServiceClient;

/**
 * @param string $formattedName The metric descriptor on which to execute the request. The format is:
 *
 *                              projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
 *
 *                              An example value of `[METRIC_ID]` is
 *                              `"compute.googleapis.com/instance/disk/read_bytes_count"`. Please see
 *                              {@see MetricServiceClient::metricDescriptorName()} for help formatting this field.
 */
function get_metric_descriptor_sample(string $formattedName): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Call the API and handle any network failures.
    try {
        /** @var MetricDescriptor $response */
        $response = $metricServiceClient->getMetricDescriptor($formattedName);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = MetricServiceClient::metricDescriptorName('[PROJECT]', '[METRIC_DESCRIPTOR]');

    get_metric_descriptor_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Api\MonitoredResourceDescriptor;
use Google\Cloud\Monitoring\V3\MetricServiceClient;

/**
 * @param string $formattedName The monitored resource descriptor to get.  The format is:
 *
 *                              projects/[PROJECT_ID_OR_NUMBER]/monitoredResourceDescriptors/[RESOURCE_TYPE]
 *
 *                              The `[RESOURCE_TYPE]` is a predefined type, such as
 *                              `cloudsql_database`. Please see
 *                              {@see MetricServiceClient::monitoredResourceDescriptorName()} for help formatting this field.
 */
function get_monitored_resource_descriptor_sample(string $formattedName): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Call the API and handle any network failures.
    try {
        /** @var MonitoredResourceDescriptor $response */
        $response = $metricServiceClient->getMonitoredResourceDescriptor($formattedName);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = MetricServiceClient::monitoredResourceDescriptorName(
        '[PROJECT]',
        '[MONITORED_RESOURCE_DESCRIPTOR]'
    );

    get_monitored_resource_descriptor_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Api\MetricDescriptor;
use Google\Cloud\Monitoring\V3\MetricServiceClient;

/**
 * @param string $name The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
 *                     which to execute the request. The format is:
 *
 *                     projects/[PROJECT_ID_OR_NUMBER]
 */
function list_metric_descriptors_sample(string $name): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $metricServiceClient->listMetricDescriptors($name);

        /** @var MetricDescriptor $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $name = '[NAME]';

    list_metric_descriptors_sample($name);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Api\MonitoredResourceDescriptor;
use Google\Cloud\Monitoring\V3\MetricServiceClient;

/**
 * @param string $name The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
 *                     which to execute the request. The format is:
 *
 *                     projects/[PROJECT_ID_OR_NUMBER]
 */
function list_monitored_resource_descriptors_sample(string $name): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $metricServiceClient->listMonitoredResourceDescriptors($name);

        /** @var MonitoredResourceDescriptor $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $name = '[NAME]';

    list_monitored_resource_descriptors_sample($name);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Monitoring\V3\ListTimeSeriesRequest\TimeSeriesView;
use Google\Cloud\Monitoring\V3\MetricServiceClient;
use Google\Cloud\Monitoring\V3\TimeInterval;
use Google\Cloud\Monitoring\V3\TimeSeries;

/**
 * @param string $formattedName The [project](https://cloud.google.com/monitoring/api/v3#project_name),
 *                              organization or folder on which to execute the request. The format is:
 *
 *                              projects/[PROJECT_ID_OR_NUMBER]
 *                              organizations/[ORGANIZATION_ID]
 *                              folders/[FOLDER_ID]
 *                              Please see {@see MetricServiceClient::workspaceName()} for help formatting this field.
 * @param string $filter        A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
 *                              that specifies which time series should be returned.  The filter must
 *                              specify a single metric type, and can additionally specify metric labels
 *                              and other information. For example:
 *
 *                              metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
 *                              metric.labels.instance_name = "my-instance-name"
 * @param int    $view          Specifies which information is returned about the time series.
 */
function list_time_series_sample(string $formattedName, string $filter, int $view): void
{
    // Create a client.
    $metricServiceClient = new MetricServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $interval = new TimeInterval();

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $metricServiceClient->listTimeSeries($formattedName, $filter, $interval, $view);

        /** @var TimeSeries $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = MetricServiceClient::workspaceName('[PROJECT]');
    $filter = '[FILTER]';
    $view = TimeSeriesView::FULL;

    list_time_series_sample($formattedName, $filter, $view);
}