Find out more about IBM Event Automation licenses and related topics.
Important: Event Automation requires the IBM License Service to be installed. For more information see tracking license usage.
Available licenses
Your use of IBM Event Automation and its capabilities must conform to the license agreement that you purchased.
The following sections list license information that must be specified when you create an Event Streams, Event Endpoint Management, or Event Processing instance. The required license depends on the program that you purchased and the intended use.
From the relevant table in the sections that follow, choose the value for the following parameters that matches your license agreement.
- The license ID (
spec.license.license
) field must contain the license identifier (ID) for the program that you purchased. - The license use (
spec.license.use
) field must match the intended product usage that you purchased. - The license acceptance (
spec.license.accept
) field must be set totrue
to indicate the acceptance of the license agreement and to proceed with installation. -
The license metric (
spec.license.metric
) field is the charging metric for the license that you purchased.Note:
spec.license.metric
field is an available option only in Event Endpoint Management. You can deploy Event Endpoint Management with a usage-based license, where usage is tracked and charged by the number of API calls handled by Event Endpoint Management. Usage is reported automatically to the IBM License Service, where usage can be tracked, monitored, and audited. Setting license metric (spec.license.metric
) toMONTHLY_API_CALL
and License ID (spec.license.license
) toL-FTGN-WUM5C5
configures the usage-based license, and sets Event Endpoint Management to automatically track API usage.Note: For IBM Operator for Apache Flink, the license configuration parameters to include in the
FlinkDeployment
custom resource are the following:spec: flinkConfiguration: license.use: <license-use-value> license.license: L-KCVZ-JL5CRM license.accept: 'true'
Where
<license-use-value>
must match the intended product usage that you purchased.
IBM Event Automation license information
Program | Included capabilities | License ID (spec.license.license ) |
License use ( spec.license.use ) |
License metric ( spec.license.metric ) |
---|---|---|---|---|
IBM Event Automation 1.1.0.0 | - Event Streams 11.5.0 and later - Event Endpoint Management 11.3.0 and later - Event Processing 1.2.0 and later |
L-KCVZ-JL5CRM | - EventAutomationNonProduction: For non-production deployments suitable for basic development and test activities. - EventAutomationProduction: For production deployments. |
N/A |
IBM Event Automation 1.0.0.0 | - Event Streams 11.2.0 to 11.4.0 - Event Endpoint Management 11.0.0 to 11.2.3 - Event Processing 1.0.0 to 1.1.9 |
L-HRZF-DWHH7A | - EventAutomationNonProduction: For non-production deployments suitable for basic development and test activities. - EventAutomationProduction: For production deployments. |
N/A |
IBM Cloud Pak for Integration license information
Program | Included capabilities | License ID (spec.license.license ) |
License use (spec.license.use ) |
License metric (spec.license.metric ) |
---|---|---|---|---|
IBM Cloud Pak for Integration 16.1.0 For more information, see the IBM Cloud Pak for Integration documentation. |
- Event Streams - Event Endpoint Management |
L-JTPV-KYG8TF | -CloudPakForIntegrationNonProduction: For non-production deployments suitable for basic development and test activities. - CloudPakForIntegrationProduction: For production deployments. |
VIRTUAL_PROCESSOR_CORE Note: Only an option for Event Endpoint Management. |
IBM Cloud Pak for Integration 16.1.0 API Calls For more information, see the IBM Cloud Pak for Integration documentation. |
- Event Endpoint Management |
L-FTGN-WUM5C5 | -CloudPakForIntegrationNonProduction: For non-production deployments suitable for basic development and test activities. - CloudPakForIntegrationProduction: For production deployments. |
MONTHLY_API_CALL Note: Only an option for Event Endpoint Management. Setting this metric and the related license ID configures the usage-based license. Note: For more information about what is charged when using the MONTHLY_API_CALL license reporting metric with Event Endpoint Management, see the Event Endpoint Management usage-based pricing example. |
IBM Cloud Pak for Integration 2023.4.1 Standard For more information, see the IBM Cloud Pak for Integration documentation. |
- Event Streams - Event Endpoint Management |
L-VTPK-22YZPK | -CloudPakForIntegrationNonProduction: For non-production deployments suitable for basic development and test activities. - CloudPakForIntegrationProduction: For production deployments. |
VIRTUAL_PROCESSOR_CORE Note: Only an option for Event Endpoint Management. |
IBM Cloud Pak for Integration 2023.4.1 API Calls For more information, see the IBM Cloud Pak for Integration documentation. |
- Event Endpoint Management | L-GGQD-G7AYJD | -CloudPakForIntegrationNonProduction: For non-production deployments suitable for basic development and test activities. - CloudPakForIntegrationProduction: For production deployments. |
MONTHLY_API_CALL Note: Only an option for Event Endpoint Management. Setting this metric and the related license ID configures the usage-based license. Note: For more information about what is charged when using the MONTHLY_API_CALL license reporting metric with Event Endpoint Management, see the Event Endpoint Management usage-based pricing example. |
IBM Cloud Pak for Integration 2023.2.1 Standard For more information, see the IBM Cloud Pak for Integration documentation. |
- Event Streams - Event Endpoint Management |
L-YBXJ-ADJNSM | -CloudPakForIntegrationNonProduction: For non-production deployments suitable for basic development and test activities. - CloudPakForIntegrationProduction: For production deployments. |
VIRTUAL_PROCESSOR_CORE Note: Only an option for Event Endpoint Management. |
IBM Cloud Pak for Integration 2023.2.1 API Calls For more information, see the IBM Cloud Pak for Integration documentation. |
- Event Endpoint Management | L-NRHE-WFD7EY | -CloudPakForIntegrationNonProduction: For non-production deployments suitable for basic development and test activities. - CloudPakForIntegrationProduction: For production deployments. |
MONTHLY_API_CALL Note: Only an option for Event Endpoint Management. Setting this metric and the related license ID configures the usage-based license. Note: For more information about what is charged when using the MONTHLY_API_CALL license reporting metric with Event Endpoint Management, see the Event Endpoint Management usage-based pricing example. |
IBM Cloud Pak for Integration 2023.2.1 Reserved or limited For more information, see the IBM Cloud Pak for Integration documentation |
Event Streams | L-PYRA-849GYQ | -CloudPakForIntegrationNonProduction: For non-production deployments suitable for basic development and test activities. - CloudPakForIntegrationProduction: For production deployments. |
N/A |
IBM Cloud Pak for Integration 2022.4.1 Reserved or limited | L-RJON-CJR2TC | |||
IBM Cloud Pak for Integration 2022.2.1 | L-RJON-CD3JKX | |||
IBM Cloud Pak for Integration 2022.2.1 Reserved or limited | L-RJON-CD3JJU | |||
IBM Cloud Pak for Integration 2021.4.1 | L-RJON-C7QG3S | |||
IBM Cloud Pak for Integration 2021.4.1 Reserved or limited | L-RJON-C7QFZX | |||
IBM Cloud Pak for Integration 2021.3.1 | L-RJON-C5CSNH | |||
IBM Cloud Pak for Integration 2021.3.1 Reserved or limited | L-RJON-C5CSM2 | |||
IBM Cloud Pak for Integration 2021.2.1 | L-RJON-BZFQU2 | |||
IBM Cloud Pak for Integration 2021.2.1 Reserved or limited | L-RJON-BZFQSB |
Note: For information about licenses for Event Streams 11.1.x and earlier, see the previous licenses for Event Streams only.
Chargeable containers
The following table lists the chargeable containers within each IBM Event Automation capability, including the container pod names for each in brackets. You can also find the list of chargeable containers documented in the product license (see links to license IDs earlier).
All other containers that might form part of the deployment are supported, and do not require additional licenses.
Event Streams capability | Event Endpoint Management capability | Event Processing capability |
---|---|---|
- Kafka brokers (kafka ) - Geo-Replicator nodes ( georep ) - MirrorMaker 2.0 nodes ( mirrormaker2 ) - Kafka Connect nodes hosted by Event Automation ( connect ) |
- Event Manager (manager ) - Event Gateway ( egw ) |
Flink Job Manager and Flink Task Manager (flink-main-container ) Note: For more information about chargeable containers for Flink, see guidance about Flink samples. |
Calculating licenses required
Licensing is based on a Virtual Processing Cores (VPC) metric. To use any capability within Event Automation, you must have sufficient licenses for the CPUs that the chargeable containers have access to (this is the CPU limit setting for these containers). Therefore, the license requirement is calculated by adding up the CPU limit values for all the chargeable containers in your deployment.
The chargeable cores for a deployment depend on the chargeable containers deployed and the resource limits specified on those containers. To understand what you will be charged for, find all your chargeable containers, and add up all the CPU limits for those containers to get the chargeable cores value.
For example, the Production 3 brokers sample deployment for Event Streams uses the setting of spec.strimziOverrides.kafka.resources.limits.cpu: 2000m
for the CPU limit, which corresponds to 2 chargeable cores per Kakfa container, and there are 3 Kafka containers deployed, so this deployment has 3x2, or 6 chargeable cores.
Note: This is an example based purely on the sample configuration. The chargeable cores for your deployment will depend on the configuration you specify. You must use the IBM License Service to track and report on license usage.
When deploying Event Automation, you require sufficient Event Automation VPCs for the number of chargeable cores in your deployment. There are separate production and non-production licenses depending on the intended use of your deployment.
If you are deploying Event Streams or Event Endpoint Management as part of IBM Cloud Pak for Integration, see the following section about how licenses and ratios are applied.
Licensing Event Streams and Event Endpoint Management within IBM Cloud Pak for Integration
The Event Streams and Event Endpoint Management capabilities are also included in IBM Cloud Pak for Integration.
IBM Cloud Pak for Integration has a ratio table with a 1:1 ratio for production deployments, and a 2:1 ratio for non-production deployments.
For example, if your production deployment consists of 12 chargeable cores, this uses the 1:1 ratio and you would require 12 IBM Cloud Pak for Integration VPCs. If you have a non-production deployment with 6 chargeable cores, this uses the 2:1 ratio, and you would require 3 IBM Cloud Pak for Integration VPCs for this deployment.
Tracking license usage
The license usage of Event Automation capabilities is tracked by the IBM License Service, which tracks the licensed containers and measures their resource usage.
The License Service provides useful features for managing virtualized environments and measuring license utilization. The service discovers the software that is installed in your infrastructure, helps you to analyze the consumption data, and allows you to generate audit reports. Each report provides you with different information about your infrastructure, for example, the computer groups, software installations, and the content of your software catalog.
By default, every License Service audit report presents data from the previous 90 days. You can customize the type and amount of information that is displayed in a report by using filters, and save your personal settings for future use. You can also export the reports to .csv or .pdf formats, and schedule report emails so that specified recipients are notified when important events occur.
Installing the service
You must install and run the License Service on all clusters where you install Event Automation capabilities. Ensure you install the License Service as follows depending on your environment and license:
- If you are running Event Automation capabilties as stand-alone containerized software, see the information about installing the service for stand-alone software.
- If you are running Event Automation capabilties as part of IBM Cloud Pak for Integration on OpenShift Container Platform with IBM Cloud Pak foundational services, see the IBM Cloud Pak for Integration documentation.
- If you are not on OpenShift and do not have foundational services, see the IBM Cloud Pak foundational services documentation.
Additional steps for usage-based license
Important: If you are planning to install Event Endpoint Management with a usage-based license, in addition to installing the License Service, ensure you also copy the secrets created by the service before creating the Event Endpoint Management instance.
To copy the secrets:
- Validate that you have a running instance of
IBMLicensing
-
Copy the secrets created by the service. The secrets will be used when creating an Event Endpoint Management instance.
Copy
ibm-license-service-cert
andibm-licensing-upload-token
to the namespace where you are planning to create the Event Endpoint Management instance.To copy
ibm-license-service-cert
:oc get secret --namespace=ibm-common-services ibm-license-service-cert -o=jsonpath='{.data.tls\.crt}' | base64 --decode > <path>/tls.crt oc get secret --namespace=ibm-common-services ibm-license-service-cert -o=jsonpath='{.data.tls\.key}' | base64 --decode > <path>/tls.key oc create secret --namespace=<your-namespace> tls ibm-license-service-cert --cert=<path>/tls.crt --key=<path>/tls.key
To copy
ibm-licensing-upload-token
:oc get secret --namespace=ibm-common-services ibm-licensing-upload-token -o yaml | sed 's/namespace: .*/namespace: <your-namespace>/' | oc apply -f -
Generating audit reports
License usage reports can be generated on a per cluster basis as described in the foundational services documentation.
It is recommended to generate reports on a monthly basis and adhere to the requirements for container licensing as described on passport advantage.
For more information about container licensing, see the container licensing FAQs.
The license usage information can be viewed by obtaining an API token that is required to make the API calls to retrieve license usage data, and then accessing provided APIs for retrieving the license usage data.
There are 3 APIs that can be viewed:
- Snapshot (last 30 days) This provides audit level information in a .zip file and is a superset of the other reports.
- Products report (last 30 days) This shows the VPC usage for all products that are deployed in IBM Cloud Pak for Integration, for example:
[{"name":"IBM Cloud Pak for Integration","id":"c8b82d189e7545f0892db9ef2731b90d","metricPeakDate":"2020-06-10","metricQuantity":3,"metricName":"VIRTUAL_PROCESSOR_CORE"}]
In this example, the
metricQuantity
is 3 indicating that the peak VPC usage is 3. - Bundled products report (last 30 days) This shows the breakdown of bundled products that are included in IBM Cloud Paks that are deployed on a cluster with the highest VPC usage within the requested period. The following example shows for Event Streams the peak number of VPCs in use, the conversion ratio and the number of licenses used:
[{"productName":"Event Streams for Non Production","productId":"<product_id>","cloudpakId":"<cloudpak_id>","metricName":"VIRTUAL_PROCESSOR_CORE","metricPeakDate":"2020-06-10","metricMeasuredQuantity":6,"metricConversion":"2:1","metricConvertedQuantity":3}]
In this example, the
productName
shows the license metrics for aEvent Streams for Non Production
deployment. ThemetricMeasuredQuantity
is 6 VPCs, themetricConversion
is 2:1 andmetricConvertedQuantity
is 3 VPCs so the license usage is 3.
Note: The metricMeasuredQuantity
is the peak number of VPCs used over the timeframe. If a capability instance (for example, Event Streams) is deleted and a new instance installed, then the quantity will be the maximum used at any one time.
License usage for multiple instances
If there are multiple production or non-production installations in a cluster, then the API will show the total peak VPC usage for all production or non-production instances in that cluster. For example, if you have 2 production instances of Event Streams where each instance has 3 Kafka brokers that each use 2 VPCs, then the total peak usage is 12 VPCs which converts to 12 licenses.
If there are production and non-production Event Streams instances installed in the cluster, then the metricConvertedQuantity
under Event Streams
and Event Streams for Non Production
will need to be added to determine the total license usage. For example:
[{"productName":"Event Streams for Non Production","productId":"<product_id>","cloudpakId":"<cloudpak_id>","metricName":"VIRTUAL_PROCESSOR_CORE","metricPeakDate":"2020-06-10","metricMeasuredQuantity":6,"metricConversion":"2:1","metricConvertedQuantity":3},{"productName":"Event Streams","productId":"<product_id>","cloudpakId":"<cloudpak_id>","metricName":"VIRTUAL_PROCESSOR_CORE","metricPeakDate":"2020-06-11","metricMeasuredQuantity":8,"metricConversion":"1:1","metricConvertedQuantity":8}]
In this example there are Event Streams installations for non-production and for production. The non-production usage is 6 VPCs which converts to 3 licenses. The production usage is 8 VPCs which converts to 8 licenses. Therefore the total license usage is 11.
License usage examples
To work out the licenses required for a deployment, you can use the sample configurations provided for each capability, and use the “chargeable cores” values to help you calculate the required licenses based on the guidance in calculating licenses required. This can provide you with examples of license usage for deployments.
See the planning sections for information about chargeable cores for each sample:
- Event Streams samples
- Event Endpoint Management samples
- Event Gateway samples
- Event Processing samples
- Flink samples
Note: The chargeable cores for your deployment will depend on the configuration you specify. If you change the chargeable core values, you will require additional licenses.