Chapter 1. Red Hat build of Cryostat Operator

Procedure

1. If you want to start creating a Cryostat instance, perform the following steps:

   1. On your Red Hat OpenShift web console, click Operators > Installed Operators.
   2. From the list of available Operators, select Red Hat build of Cryostat.
   3. On the Operator details page, click the Details tab.
   4. In the Provided APIs section, select Cryostat, and then click Create instance.

2. On the Create Cryostat panel, to configure the enableCertManager property, choose one of the following options:

   1. If you want to use the Form view:

      1. Click the Form view radio button.

      2. Set the Enable cert-manager Integration switch to false, and then enter a value in the Name field.

         Figure 1.1. Toggling the Enable cert-manager Integration switch to false

         

         View larger image

         

   2. If you want to use the YAML view:

      1. Click the YAML view radio button.

      2. In the spec: key set of the YAML file, change the enableCertManager property to false.

         Example of configuring the spec: key set in a YAML file

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           enableCertManager: false
         --

         Copy to Clipboard Toggle word wrap

3. If you want to configure other properties in the custom resource (CR) for this Cryostat instance, see the other sections of this document for more information about these properties.
4. If you want to finish creating this Cryostat instance, click Create.

Verification

1. Select your Cryostat instance from the Cryostat tab on the Operator details page.
2. Navigate to the Cryostat Conditions table.

3. Verify that the TLSSetupComplete condition is set to true and that the Reason column for this condition is set to CertManagerDisabled. This indicates that you have set the enableCertManager property to false.

   Figure 1.2. Example showing the TLSSetupComplete condition set to true

   

   View larger image

   

Procedure

1. To download a default event template, navigate to your Cryostat web console and from the Events menu, click Downloads.

   Note

   Event templates are in XML format and have a file name extension of .jfc.

2. Optional: If you want a custom event template, edit the downloaded default event template by using a text editor or XML editor to configure the template to meet your needs.
3. Log in to your Red Hat OpenShift web console by entering the oc login command in your CLI.

4. Create a ConfigMap resource from the event template by entering the following command in your CLI. You must issue the command in the path where you want to deploy your Cryostat application. You can use this resource to store an event template file that is inside the cluster where you run your Cryostat instance.

   Example of creating a ConfigMap resource by using the CLI

   $ oc create configmap <template_name> --from-file=<path_to_custom_event_template>

   Copy to Clipboard Toggle word wrap

5. If you want to start creating a Cryostat instance, perform the following steps:

   1. On your Red Hat OpenShift web console, click Operators > Installed Operators.
   2. From the list of available Operators, select Red Hat build of Cryostat.
   3. On the Operator details page, click the Details tab.
   4. In the Provided APIs section, select Cryostat, and then click Create instance.

6. On the Create Cryostat panel, to upload an event template in XML format into a resource, choose one of the following options:

   1. If you want to use the Form view:

      1. Click the Form view radio button.
      2. Navigate to the Event Templates section of the Cryostat instance.
      3. From the Event Templates menu, click Add Event Template. An Event Templates section opens on your Red Hat OpenShift console.

      4. From the Config Map Name drop-down list, select the ConfigMap resource that contains your event template.

         Figure 1.3. Event Templates option for a Cryostat instance

         

         View larger image

         
      5. In the Filename field, enter the name of the .jfc file that is contained within your ConfigMap.

   2. If you want to use the YAML view:

      1. Click the YAML view radio button.

      2. Specify any custom event templates for the eventTemplates property. This property points the Red Hat build of Cryostat Operator to your ConfigMap, so that the Red Hat build of Cryostat Operator can read the event template.

         Example of specifying custom event templates for the eventTemplates property

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           eventTemplates:
           - configMapName: custom-template1
             filename: my-template1.jfc
           - configMapName: custom-template2
             filename: my-template2.jfc
         --

         Copy to Clipboard Toggle word wrap

         Important

         You must select the name of a ConfigMap, which is associated with your Cryostat or Cluster Cryostat instance, from the configMapName drop-down list. Additionally, you must specify a key associated with the ConfigMap in the filename field.

7. If you want to configure other properties in the custom resource (CR) for this Cryostat instance, see the other sections of this document for more information about these properties.
8. If you want to finish creating this Cryostat instance, click Create.

Verification

1. On the Cryostat web console, click Events from the menu. If an Authentication Required window opens on your web console, enter your credentials and click Save.

2. Under the Event Templates tab, check if your custom event template shows in the list of available event templates.

   Figure 1.4. Example of a listed custom event template under the Event Templates tab

   

   View larger image

   

Procedure

1. If you want to start creating a Cryostat instance, perform the following steps:

   1. On your Red Hat OpenShift web console, click Operators > Installed Operators.
   2. From the list of available Operators, select Red Hat build of Cryostat.
   3. On the Operator details page, click the Details tab.
   4. In the Provided APIs section, select Cryostat, and then click Create instance.

2. On the Create Cryostat panel, to configure a TLS certificate, choose one of the following options:

   1. If you want to use the Form view:

      1. Click the Form view radio button.
      2. In the Name field, specify a name for the instance of Cryostat that you want to create.

      3. Expand the Trusted TLS Certificates option, then click Add Trusted TLS Certificates. A list of options displays on your Red Hat OpenShift web console.

         Figure 1.5. The Trusted TLS Certificates option

         

         View larger image

         

      4. Select a TLS secret from the Secret Name list. The Certificate Key field is optional.

         Note

         You can remove a TLS certificate by clicking Remove Trusted TLS Certificates.

   2. If you want to use the YAML view:

      1. Click the YAML view radio button.

      2. Specify your secret, which is located in the same namespace as your Cryostat application, in the secretName property of the trustedCertSecrets array.

         Example of specifying a secret in the trustedCertSecrets array

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           trustedCertSecrets:
           - secretName: my-tls-secret
         --

         Copy to Clipboard Toggle word wrap

      3. Optional: Change the certificateKey property value to the application’s X.509 certificate file name. If you do not change the value, the certificateKey property defaults to tls.crt.

         Example of changing the certificateKey property’s value

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           trustedCertSecrets:
           - secretName: my-tls-secret
             certificateKey: ca.crt
         --

         Copy to Clipboard Toggle word wrap

3. If you want to configure other properties in the custom resource (CR) for this Cryostat instance, see the other sections of this document for more information about these properties.
4. If you want to finish creating this Cryostat instance, click Create.

Verification

1. Determine that all your application pods exist in the same OpenShift cluster namespace as your Cryostat pod by issuing the following command in your CLI:

   $ oc get pods

   Copy to Clipboard Toggle word wrap
2. Log in to the web console of your Cryostat instance.
3. On the Dashboard menu for your Cryostat instance, select a target JVM from the Target list.

4. In the navigation menu on the Cryostat web console, select Recordings. On the Authentication Required dialog window, enter your secret’s credentials and then select Save to provide your credentials to the target JVM.

   Note

   If the selected target has password authentication enabled for JMX connections, you must provide the JMX credentials for the target JVM when prompted for a connection.

   Cryostat connects to your application through the authenticated JMX connection. You can now use the Recordings and Events functions to monitor your application’s JFR data.

Procedure

1. If you want to start creating a Cryostat instance, perform the following steps:

   1. On your Red Hat OpenShift web console, click Operators > Installed Operators.
   2. From the list of available Operators, select Red Hat build of Cryostat.
   3. On the Operator details page, click the Details tab.
   4. In the Provided APIs section, select Cryostat, and then click Create instance.

2. On the Create Cryostat panel, to change storage settings for your Cryostat application, choose one of the following options:

   1. If you want to use the Form view:

      1. Click the Form view radio button.
      2. Navigate to the Storage Options section, and enter a value in the Name field.
      3. Expand Storage Options and click Empty Dir. An expanded selection of options opens on your Red Hat OpenShift web console.

      4. Set the Enabled switch to true.

         Figure 1.6. Example showing the Empty Dir switch set to true

         

         View larger image

         

   2. If you want to use the YAML view:

      1. Click the YAML view radio button.

      2. In the spec: key set of the YAML file, add the storageOptions definition and set the emptyDir property to true.

         Example showing the emptyDir property set as true

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           storageOptions:
             emptyDir:
               enabled: true
               medium: "Memory"
               sizeLimit: 1Gi
         --

         Copy to Clipboard Toggle word wrap

      3. Optional: Set values for the medium and sizeLimit properties.
3. If you want to configure other properties in the custom resource (CR) for this Cryostat instance, see the other sections of this document for more information about these properties.
4. If you want to finish creating this Cryostat instance, click Create.