org.apache.pulsar.broker.resourcegroup

Class ResourceGroupService

java.lang.Object

org.apache.pulsar.broker.resourcegroup.ResourceGroupService

public class ResourceGroupService
extends Object

The ResourceGroupService contains APIs to manipulate resource groups. It is assumed that there is a single instance of the ResourceGroupService on each broker. The control plane operations are somewhat stringent, and throw exceptions if (for instance) the op refers to a resource group which does not exist. The data plane operations (e.g., increment stats) throw exceptions as a last resort; if (e.g.) increment stats refers to a non-existent resource group, the stats are quietly not incremented.

See Also:

PulsarService

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ResourceGroupService.ResourceGroupOpStatus

Field Summary

Fields

Modifier and Type	Field and Description
protected static long	maxIntervalForSuppressingReportsMSecs
protected static int	MaxUsageReportSuppressRounds
protected ResourceQuotaCalculator	quotaCalculator
protected static float	UsageReportSuppressionTolerancePercentage

Constructor Summary

Constructors

Constructor and Description
ResourceGroupService(PulsarService pulsar) Default constructor.
ResourceGroupService(PulsarService pulsar, TimeUnit timescale, ResourceUsageTransportManager transportMgr, ResourceQuotaCalculator quotaCalc)

Method Summary

Modifier and Type	Method and Description
protected void	aggregateResourceGroupLocalUsages()
protected long	getNumResourceGroups() Get the current number of RGs.
protected ResourceGroup.BytesAndMessagesCount	getRGUsage(String rgName, ResourceGroup.ResourceGroupMonitoringClass monClass)
boolean	incrementUsage(String tenantName, String nsName, ResourceGroup.ResourceGroupMonitoringClass monClass, ResourceGroup.BytesAndMessagesCount incStats) Increments usage stats for the resource groups associated with the given namespace and tenant.
void	registerNameSpace(String resourceGroupName, String namespaceName) Registers a namespace as a user of a resource group.
void	registerTenant(String resourceGroupName, String tenantName) Registers a tenant as a user of a resource group.
void	resourceGroupCreate(ResourceGroupConfigInfo rgConfig) Create RG.
void	resourceGroupCreate(ResourceGroupConfigInfo rgConfig, ResourceUsagePublisher rgPublisher, ResourceUsageConsumer rgConsumer) Create RG, with non-default functions for resource-usage transport-manager.
void	resourceGroupDelete(String name) Delete RG.
ResourceGroup	resourceGroupGet(String resourceGroupName) Get a copy of the RG with the given name.
void	resourceGroupUpdate(ResourceGroupConfigInfo rgConfig) Update RG.
void	unRegisterNameSpace(String resourceGroupName, String namespaceName) UnRegisters a namespace from a resource group.
void	unRegisterTenant(String resourceGroupName, String tenantName) UnRegisters a tenant from a resource group.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

quotaCalculator

protected final ResourceQuotaCalculator quotaCalculator

MaxUsageReportSuppressRounds

protected static final int MaxUsageReportSuppressRounds

See Also:

Constant Field Values

maxIntervalForSuppressingReportsMSecs

protected static long maxIntervalForSuppressingReportsMSecs

UsageReportSuppressionTolerancePercentage

protected static final float UsageReportSuppressionTolerancePercentage

See Also:

Constant Field Values

Constructor Detail

ResourceGroupService

public ResourceGroupService(PulsarService pulsar)

Default constructor.

ResourceGroupService

public ResourceGroupService(PulsarService pulsar,
                            TimeUnit timescale,
                            ResourceUsageTransportManager transportMgr,
                            ResourceQuotaCalculator quotaCalc)

Method Detail

resourceGroupCreate

public void resourceGroupCreate(ResourceGroupConfigInfo rgConfig)
                         throws PulsarAdminException

Create RG.

Throws:

if - RG with that name already exists.

PulsarAdminException

resourceGroupCreate

public void resourceGroupCreate(ResourceGroupConfigInfo rgConfig,
                                ResourceUsagePublisher rgPublisher,
                                ResourceUsageConsumer rgConsumer)
                         throws PulsarAdminException

Create RG, with non-default functions for resource-usage transport-manager.

Throws:

if - RG with that name already exists (even if the resource usage handlers are different).

PulsarAdminException

resourceGroupGet

public ResourceGroup resourceGroupGet(String resourceGroupName)

Get a copy of the RG with the given name.

resourceGroupUpdate

public void resourceGroupUpdate(ResourceGroupConfigInfo rgConfig)
                         throws PulsarAdminException

Update RG.

Throws:

if - RG with that name does not exist.

PulsarAdminException

resourceGroupDelete

public void resourceGroupDelete(String name)
                         throws PulsarAdminException

Delete RG.

Throws:

if - RG with that name does not exist, or if the RG exists but is still in use.

PulsarAdminException

getNumResourceGroups

protected long getNumResourceGroups()

Get the current number of RGs. For testing.

registerTenant

public void registerTenant(String resourceGroupName,
                           String tenantName)
                    throws PulsarAdminException

Registers a tenant as a user of a resource group.

Parameters:

resourceGroupName -

tenantName -

Throws:

if - the RG does not exist, or if the NS already references the RG.

PulsarAdminException

unRegisterTenant

public void unRegisterTenant(String resourceGroupName,
                             String tenantName)
                      throws PulsarAdminException

UnRegisters a tenant from a resource group.

Parameters:

resourceGroupName -

tenantName -

Throws:

if - the RG does not exist, or if the tenant does not references the RG yet.

PulsarAdminException

registerNameSpace

public void registerNameSpace(String resourceGroupName,
                              String namespaceName)
                       throws PulsarAdminException

Registers a namespace as a user of a resource group.

Parameters:

resourceGroupName -

namespaceName -

Throws:

if - the RG does not exist, or if the NS already references the RG.

PulsarAdminException

unRegisterNameSpace

public void unRegisterNameSpace(String resourceGroupName,
                                String namespaceName)
                         throws PulsarAdminException

UnRegisters a namespace from a resource group.

Parameters:

resourceGroupName -

namespaceName -

Throws:

if - the RG does not exist, or if the NS does not references the RG yet.

PulsarAdminException

incrementUsage

public boolean incrementUsage(String tenantName,
                              String nsName,
                              ResourceGroup.ResourceGroupMonitoringClass monClass,
                              ResourceGroup.BytesAndMessagesCount incStats)
                       throws PulsarAdminException

Increments usage stats for the resource groups associated with the given namespace and tenant. Expected to be called when a message is produced or consumed on a topic, or when we calculate usage periodically in the background by going through broker-service stats. [Not yet decided which model we will follow.] Broker-service stats will be cumulative, while calls from the topic produce/consume code will be per-produce/consume. If the tenant and NS are associated with different RGs, the statistics on both RGs are updated. If the tenant and NS are associated with the same RG, the stats on the RG are updated only once (to avoid a direct double-counting). ToDo: will this distinction result in "expected semantics", or shock from users? For now, the only caller is internal to this class.

Parameters:

tenantName -

nsName -

monClass -

incStats -

Throws:

PulsarAdminException

getRGUsage

protected ResourceGroup.BytesAndMessagesCount getRGUsage(String rgName,
                                                         ResourceGroup.ResourceGroupMonitoringClass monClass)
                                                  throws PulsarAdminException

Throws:

PulsarAdminException

aggregateResourceGroupLocalUsages

protected void aggregateResourceGroupLocalUsages()