6.2. Writing Reports

Procedure

1. Change to the openshift-metering project:

   $ oc project openshift-metering

2. Create a Report resource as a YAML file:

   1. Create a YAML file with the following content:

      apiVersion: metering.openshift.io/v1
      kind: Report
      metadata:
        name: namespace-cpu-request-2019 1
        namespace: openshift-metering
      spec:
        reportingStart: '2019-01-01T00:00:00Z'
        reportingEnd: '2019-12-30T23:59:59Z'
        query: namespace-cpu-request 2
        runImmediately: true 3

      2

      The query specifies the ReportQuery resources used to generate the report. Change this based on what you want to report on. For a list of options, run oc get reportqueries | grep -v raw.

      1

      Use a descriptive name about what the report does for metadata.name. A good name describes the query, and the schedule or period you used.

      3

      Set runImmediately to true for it to run with whatever data is available, or set it to false if you want it to wait for reportingEnd to pass.

   2. Run the following command to create the Report resource:

      $ oc create -f <file-name>.yaml

      Example output

      report.metering.openshift.io/namespace-cpu-request-2019 created

3. You can list reports and their Running status with the following command:

   $ oc get reports

   Example output

   NAME                         QUERY                   SCHEDULE   RUNNING    FAILED   LAST REPORT TIME       AGE
   namespace-cpu-request-2019   namespace-cpu-request              Finished            2019-12-30T23:59:59Z   26s