org.cloudsimplus.autoscaling.VerticalVmScalingSimple Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of cloudsim-plus Show documentation
Show all versions of cloudsim-plus Show documentation
CloudSim Plus: A modern, highly extensible and easier-to-use Java 8 Framework for Modeling and Simulation of Cloud Computing Infrastructures and Services
/*
* CloudSim Plus: A modern, highly-extensible and easier-to-use Framework for
* Modeling and Simulation of Cloud Computing Infrastructures and Services.
* http://cloudsimplus.org
*
* Copyright (C) 2015-2018 Universidade da Beira Interior (UBI, Portugal) and
* the Instituto Federal de Educação Ciência e Tecnologia do Tocantins (IFTO, Brazil).
*
* This file is part of CloudSim Plus.
*
* CloudSim Plus is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* CloudSim Plus is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with CloudSim Plus. If not, see .
*/
package org.cloudsimplus.autoscaling;
import org.cloudbus.cloudsim.brokers.DatacenterBroker;
import org.cloudbus.cloudsim.core.CloudSimTags;
import org.cloudbus.cloudsim.resources.*;
import org.cloudbus.cloudsim.vms.Vm;
import org.cloudsimplus.autoscaling.resources.ResourceScaling;
import org.cloudsimplus.autoscaling.resources.ResourceScalingGradual;
import org.cloudsimplus.autoscaling.resources.ResourceScalingInstantaneous;
import org.cloudsimplus.listeners.VmHostEventInfo;
import java.util.Objects;
import java.util.function.Function;
/**
* A {@link VerticalVmScaling} implementation which allows a {@link DatacenterBroker}
* to perform on demand up or down scaling for some {@link Vm} resource, such as {@link Ram}, {@link Pe} or {@link Bandwidth}.
*
* For each resource that is required to be scaled, a distinct {@link VerticalVmScaling}
* instance must be assigned to the VM to be scaled.
*
* @author Manoel Campos da Silva Filho
* @since CloudSim Plus 1.1.0
*/
public class VerticalVmScalingSimple extends VmScalingAbstract implements VerticalVmScaling {
private ResourceScaling resourceScaling;
private double scalingFactor;
private Class resourceClassToScale;
private Function upperThresholdFunction;
private Function lowerThresholdFunction;
/**
* Creates a VerticalVmScalingSimple with a {@link ResourceScalingGradual} scaling type.
*
* @param resourceClassToScale the class of Vm resource that this scaling object will request up or down scaling
* (such as {@link Ram}.class, {@link Bandwidth}.class or {@link Processor}.class).
* @param scalingFactor the factor (a percentage value in scale from 0 to 1)
* that will be used to scale a Vm resource up or down,
* whether such a resource is over or underloaded, according to the
* defined predicates.
* In the case of up scaling, the value 1 will scale the resource in 100%,
* doubling its capacity.
* @see VerticalVmScaling#setResourceScaling(ResourceScaling)
*/
public VerticalVmScalingSimple(final Class resourceClassToScale, final double scalingFactor){
super();
this.setResourceScaling(new ResourceScalingGradual());
this.lowerThresholdFunction = VerticalVmScaling.NULL.getLowerThresholdFunction();
this.upperThresholdFunction = VerticalVmScaling.NULL.getUpperThresholdFunction();
this.setResourceClass(resourceClassToScale);
this.setScalingFactor(scalingFactor);
}
@Override
public Function getUpperThresholdFunction() {
return upperThresholdFunction;
}
@Override
public final VerticalVmScaling setUpperThresholdFunction(final Function upperThresholdFunction) {
validateFunctions(lowerThresholdFunction, upperThresholdFunction);
this.upperThresholdFunction = upperThresholdFunction;
return this;
}
@Override
public Function getLowerThresholdFunction() {
return lowerThresholdFunction;
}
@Override
public final VerticalVmScaling setLowerThresholdFunction(final Function lowerThresholdFunction) {
validateFunctions(lowerThresholdFunction, upperThresholdFunction);
this.lowerThresholdFunction = lowerThresholdFunction;
return this;
}
/**
* {@inheritDoc}
* This class's constructors define a {@link ResourceScalingGradual}
* as the default {@link ResourceScaling}.
* @param resourceScaling {@inheritDoc}
* @return {@inheritDoc}
*/
@Override
public final VerticalVmScaling setResourceScaling(final ResourceScaling resourceScaling) {
this.resourceScaling = Objects.requireNonNull(resourceScaling);
return this;
}
@Override
public long getAllocatedResource() {
return getResource().getAllocatedResource();
}
/**
* Throws an exception if the under and overload predicates are equal (to make clear
* that over and under-load situations must be defined by different conditions)
* or if any of them are null.
*
* @param lowerThresholdFunction the lower threshold function
* @param upperThresholdFunction the upper threshold function
* @throws IllegalArgumentException if the two functions are equal
* @throws NullPointerException if any of the functions is null
*/
private void validateFunctions(
final Function lowerThresholdFunction,
final Function upperThresholdFunction)
{
Objects.requireNonNull(lowerThresholdFunction);
Objects.requireNonNull(upperThresholdFunction);
if(upperThresholdFunction.equals(lowerThresholdFunction)){
throw new IllegalArgumentException("Lower and Upper utilization threshold functions cannot be equal.");
}
}
@Override
public Class getResourceClass() {
return this.resourceClassToScale;
}
@Override
public final VerticalVmScaling setResourceClass(final Class resourceClass) {
this.resourceClassToScale = Objects.requireNonNull(resourceClass);
if(Pe.class.equals(this.resourceClassToScale)){
this.resourceClassToScale = Processor.class;
}
return this;
}
@Override
public double getScalingFactor() {
return scalingFactor;
}
@Override
public final boolean requestUpScalingIfPredicateMatches(final VmHostEventInfo evt) {
if(!isTimeToCheckPredicate(evt.getTime())) {
return false;
}
final boolean requestedScaling = (isVmUnderloaded() || isVmOverloaded()) && requestUpScaling(evt.getTime());
setLastProcessingTime(evt.getTime());
return requestedScaling;
}
@Override
public boolean isVmUnderloaded() {
return getResource().getPercentUtilization() < lowerThresholdFunction.apply(getVm());
}
@Override
public boolean isVmOverloaded() {
return getResource().getPercentUtilization() > upperThresholdFunction.apply(getVm());
}
@Override
public Resource getResource() {
return getVm().getResource(resourceClassToScale);
}
/**
* {@inheritDoc}
*
* If a {@link ResourceScaling} implementation such as
* {@link ResourceScalingGradual} or {@link ResourceScalingInstantaneous} are used,
* it will rely on the {@link #getScalingFactor()} to compute the amount of resource to scale.
* Other implementations may use the scaling factor by it is up to them.
*
*
* NOTE:
* The return of this method is rounded up to avoid
* values between ]0 and 1[. For instance, up scaling the number of CPUs in 0.5
* means that half of a CPU should be added to the VM. Since number of CPUs is
* an integer value, this 0.5 will be converted to zero, causing no effect.
* For other resources such as RAM, adding 0.5 MB has not practical advantages either.
* This way, the value is always rounded up.
*
* @return {@inheritDoc}
*/
@Override
public double getResourceAmountToScale() {
return Math.ceil(resourceScaling.getResourceAmountToScale(this));
}
@Override
public Function getResourceUsageThresholdFunction(){
if(isVmUnderloaded()) {
return lowerThresholdFunction;
} else if(isVmOverloaded()) {
return upperThresholdFunction;
}
return vm -> 0.0;
}
@Override
public final VerticalVmScaling setScalingFactor(final double scalingFactor) {
this.scalingFactor = scalingFactor;
return this;
}
@Override
protected boolean requestUpScaling(final double time) {
final DatacenterBroker broker = this.getVm().getBroker();
//@TODO Previously, the src was the VM and the dest the broker. However, the VM isn't a SimEntity. See if this change brakes anything
broker.getSimulation().sendNow(broker, broker, CloudSimTags.VM_VERTICAL_SCALING, this);
return true;
}
}