BackendMonitor.java revision b52956de75caa2be959a4bdc768462070aa6549f
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at legal-notices/CDDLv1_0.txt.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information:
* Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*
*
* Copyright 2006-2010 Sun Microsystems, Inc.
* Portions Copyright 2014-2015 ForgeRock AS
*/
/**
* A monitor provider for high level backend statistics, such as filter stats and search counters.
*/
{
/** Represents the statistical information kept for each search filter. */
{
private long maxMatchingEntries = -1;
}
{
this.failureReason = failureReason;
}
{
synchronized(this)
{
{
}
}
}
}
/** The name of this monitor instance. */
/** The root container to be monitored. */
private final RootContainer rootContainer;
private int maxEntries = 1024;
private boolean filterUseEnabled;
private String startTimeStamp;
/**
* Creates a new backend monitor.
* @param name The monitor instance name.
* @param rootContainer A root container handle for the backend to be
* monitored.
*/
{
this.rootContainer = rootContainer;
}
/** {@inheritDoc} */
{
}
/**
* Retrieves the name of this monitor provider. It should be unique among all
* monitor providers, including all instances of the same monitor provider.
*
* @return The name of this monitor provider.
*/
public String getMonitorInstanceName()
{
return name;
}
/**
* Retrieves a set of attributes containing monitor data that should be
* returned to the client if the corresponding monitor entry is requested.
*
* @return A set of attributes containing monitor data that should be
* returned to the client if the corresponding monitor entry is
* requested.
*/
{
{
{
{
}
}
}
{
}
if(filterUseEnabled)
{
synchronized(filterToStats)
{
{
}
}
}
return monitorAttrs;
}
/**
* Updates the index filter statistics with this latest search filter
* and the reason why an index was not used.
*
* @param searchFilter The search filter that was evaluated.
* @param failureMessage The reason why an index was not used.
*/
{
if(!filterUseEnabled)
{
return;
}
synchronized(filterToStats)
{
{
}
else
{
stats = new FilterStats();
}
}
}
/**
* Updates the index filter statistics with this latest search filter
* and the number of entries matched by the index lookup.
*
* @param searchFilter The search filter that was evaluated.
* @param matchingEntries The number of entries matched by the successful
* index lookup.
*/
{
if(!filterUseEnabled)
{
return;
}
synchronized(filterToStats)
{
{
}
else
{
stats = new FilterStats();
}
}
}
/**
* Enable or disable index filter statistics gathering.
*
* @param enabled <code>true></code> to enable index filter statics gathering.
*/
void enableFilterUseStats(boolean enabled)
{
if(enabled && !filterUseEnabled)
{
}
else if(!enabled)
{
}
}
/**
* Indicates if index filter statistics gathering is enabled.
*
* @return <code>true</code> If index filter statistics gathering is enabled.
*/
boolean isFilterUseEnabled()
{
return filterUseEnabled;
}
/**
* Sets the maximum number of search filters statistics entries to keep
* before ones with the least hits will be removed.
*
* @param maxEntries The maximum number of search filters statistics
* entries to keep
*/
void setMaxEntries(int maxEntries)
{
this.maxEntries = maxEntries;
}
/**
* Updates the statistics counter to include an indexed search.
*/
void updateIndexedSearchCount()
{
if (filterUseEnabled)
{
}
}
/**
* Updates the statistics counter to include an unindexed search.
*/
void updateUnindexedSearchCount()
{
if (filterUseEnabled)
{
}
}
private void removeLowestHit()
{
{
{
{
}
}
}
}
}