@Generated(value="com.neeve.adm.AdmXbufGenerator", date="Fri Dec 05 13:32:50 UTC 2025") @AdmGenerated(encoding="Xbuf", compatLevel="4.1.0", admVersion="Unknown Version", date="12/5/25 1:32 PM", buildInfo="nvx-talon-3.16.63 (nvx-codegen-plugin)") @AdmFactoryInfo(factoryClass=SrvMonFactory.class, vfid=32, ofid=32, typeId=105) public final class SrvMonIntSeries extends Object implements com.neeve.xbuf.IXbufDesyncer, UtlPool.Item<SrvMonIntSeries>, ISrvMonIntSeries
SrvMonIntSeries reports interval and running histogram data for a series of integer data points. It may also be used to report the captured datapoints, but because reporting the raw data is costly both in terms of collection and size/bandwidth the captured values are typically not reported. SrvMonIntSeries is frequently used to capture measured latency timings, but can also be used to capture any integer data series.
| ADM Type | Embedded Entity |
| Factory | SrvMonFactory |
| ADM Field Summary |
|---|
| Field | Type | Id | Description |
|---|---|---|---|
| dataPoints | Integer[] | 16 |
Holds the collected raw data points (when reported).
When the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored. |
| intervalStats | SrvMonIntHistogram |
19 |
Computed latency statistics for the collection period corresponding to this heartbeat.
Hold computed results for the datpoints captured for this heartbeat (e.g. for the numDataPoints captured). This field may not be set if numDataPoints is 0 or if interval computations are not done on the XVM. |
| lastSequenceNumber | Long | 17 |
The sequence number of the last data point collected or 0 if no data points have been collected.
Sequence numbers for collected data points start at 1, a value of 0 indicates that no data points have been collected. The Sequence Number always indicates the number or data points that have been collected since the statistic has been created or was last reset. If the statistic is reset then this value will reset to 0, when |
| numDataPoints | Integer | 18 |
The number of data points collected in this interval.
Indicates the number of data points collected in this interval. If no data points were collected numDataPoints will be 0. The sequence number of the first value collected in this interval can be determined by subtracting numDataPoints from lastSequenceNumber. This can be used to determine if two consecutive datapoints have skipped data points due to under sampling or a missing heartbeat. |
| runningStats | SrvMonIntHistogram |
20 |
Computed latency statistics over the lifetime of the metric being collected.
Hold computed results for the datpoints over the lifetime of this statistics (e.g. since seqNo 1). If the underlying statistic is reset then the running stats are also corresponding reset. |
| skippedDatapoints | Long | 21 |
The number of data points skipped due to undersampling.
The runtime only holds on to a fixed number of data points for any particular statistic. If the sampling interval is too high then some datapoints may be skipped. For example let's say Latency stats are configured to hold on to a sample size of 1000 datapoints. If the number of data points being captured per second is 2000, and the stats collection interval is 1 second then on each collection, 1000 datapoints will be missed which will skew results. The skipped data points counter thus indicates how many datapoints have been missed in the reported runningStats. And if the count grows over two successive heartbeats indicates that the values the intervalStats don't reflect all the activity since the last interval. The skipped data points counter is a running counter ... it tracks the total number of data points that have been skipped since the underlying statistic was last reset. |
| Modifier and Type | Class and Description |
|---|---|
static class |
SrvMonIntSeries.Field
The SrvMonIntSeries xbuf field (used internally when this entity is used as a field of another entity).
|
static class |
SrvMonIntSeries.ListField
The SrvMonIntSeries list field (used internally when this entity is used as an array field of another entity).
|
| Modifier and Type | Field and Description |
|---|---|
static SrvMonIntSeries[] |
EMPTY_ARRAY
A preallocated empty array used to avoid garbage when returning empty arrays of this type.
|
| Constructor and Description |
|---|
SrvMonIntSeries() |
SrvMonIntSeries(int initialBackingBufferSize) |
| Modifier and Type | Method and Description |
|---|---|
SrvMonIntSeries |
acquire() |
void |
addDataPoints(int val)
Adds the provided value to the list of 'dataPoints' values.
|
void |
clearContent() |
void |
clearDataPoints()
Clears the value of 'dataPoints'.
|
void |
clearIntervalStats()
Clears the value of 'intervalStats'.
|
void |
clearLastSequenceNumber()
Clears the value of 'lastSequenceNumber'.
|
void |
clearNumDataPoints()
Clears the value of 'numDataPoints'.
|
void |
clearRunningStats()
Clears the value of 'runningStats'.
|
void |
clearSkippedDatapoints()
Clears the value of 'skippedDatapoints'.
|
void |
clearXRogType() |
Object |
clone()
Creates a clone of this object.
|
SrvMonIntSeries |
copy()
Creates a copy of this SrvMonIntSeries.
|
void |
copyInto(SrvMonIntSeries copy)
Copies the contents of this SrvMonIntSeries into the target.
|
static SrvMonIntSeries |
create() |
static com.neeve.xbuf.XbufRepeatedIntFieldBuffer |
createDataPointsFieldBuffer(int initialBufferLength,
boolean isNative)
Returns a wrapped buffer that can be used for doing an efficient bulk
copy from an XIterator returned for this field.
|
static SrvMonIntSeries |
createFrom(byte[] serializedContainer) |
static SrvMonIntSeries |
createFrom(byte[] serializedContainer,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
static SrvMonIntSeries |
createFromSerializedXbufContainer(byte[] serializedContainer) |
static SrvMonIntSeries |
createFromSerializedXbufContainer(byte[] serializedContainer,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
static com.neeve.xbuf.XbufSchema |
createSchema() |
SrvMonIntSeries |
deserializeFromByteArray(byte[] array) |
SrvMonIntSeries |
deserializeFromByteArray(byte[] array,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
SrvMonIntSeries |
deserializeFromByteBuffer(ByteBuffer buffer) |
SrvMonIntSeries |
deserializeFromByteBuffer(ByteBuffer buffer,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
SrvMonIntSeries |
deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer,
int offset,
int length) |
SrvMonIntSeries |
deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer,
int offset,
int length,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
SrvMonIntSeries |
deserializeFromNative(long address,
int offset,
int length) |
SrvMonIntSeries |
deserializeFromNative(long address,
int offset,
int length,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
int |
desync(PktBuffer buffer,
int pos,
boolean frameOnly)
Desync fields from a buffer
|
void |
desyncFieldBitmask() |
void |
dispose() |
PktBuffer |
getBackingBuffer() |
int[] |
getDataPoints()
Gets the value of 'dataPoints'.
|
int[] |
getDataPointsEmptyIfNull()
Gets the value of 'dataPoints' or an empty array if the value is
null or not set. |
static int |
getDataPointsFieldId() |
XIntIterator |
getDataPointsIterator()
Gets the value of 'dataPoints' as iterator of values.
|
static com.neeve.xbuf.XbufDesyncPolicy |
getDesyncPolicy() |
SrvMonIntHistogram |
getIntervalStats()
Gets the value of 'intervalStats'.
|
static int |
getIntervalStatsFieldId() |
void |
getIntervalStatsTo(SrvMonIntHistogram to)
Copies the value of SrvMonIntHistogram into the provided value.
|
boolean |
getIsReadOnly() |
long |
getLastSequenceNumber()
Gets the value of 'lastSequenceNumber'.
|
Long |
getLastSequenceNumberAsObject()
Gets the value of 'lastSequenceNumber'.
|
com.neeve.xbuf.XbufVariableLongField |
getLastSequenceNumberField() |
static int |
getLastSequenceNumberFieldId() |
int |
getNumDataPoints()
Gets the value of 'numDataPoints'.
|
Integer |
getNumDataPointsAsObject()
Gets the value of 'numDataPoints'.
|
com.neeve.xbuf.XbufVariableIntField |
getNumDataPointsField() |
static int |
getNumDataPointsFieldId() |
int |
getOwnerCount() |
UtlPool<SrvMonIntSeries> |
getPool()
Get a pool item's pool.
|
SrvMonIntHistogram |
getRunningStats()
Gets the value of 'runningStats'.
|
static int |
getRunningStatsFieldId() |
void |
getRunningStatsTo(SrvMonIntHistogram to)
Copies the value of SrvMonIntHistogram into the provided value.
|
int |
getSerializeToNativeLength() |
long |
getSkippedDatapoints()
Gets the value of 'skippedDatapoints'.
|
Long |
getSkippedDatapointsAsObject()
Gets the value of 'skippedDatapoints'.
|
com.neeve.xbuf.XbufVariableLongField |
getSkippedDatapointsField() |
static int |
getSkippedDatapointsFieldId() |
void |
getValidationErrors(List<XString> results,
String errorPrefix)
Collects validation errors into the provided list.
|
short |
getXRogType() |
Short |
getXRogTypeAsObject() |
com.neeve.xbuf.XbufVariableShortField |
getXRogTypeField() |
static int |
getXRogTypeFieldId() |
boolean |
hasIntervalStats()
Checks for the presence of 'intervalStats'.
|
boolean |
hasLastSequenceNumber()
Checks for the presence of 'lastSequenceNumber'.
|
boolean |
hasNumDataPoints()
Checks for the presence of 'numDataPoints'.
|
boolean |
hasRunningStats()
Checks for the presence of 'runningStats'.
|
boolean |
hasSkippedDatapoints()
Checks for the presence of 'skippedDatapoints'.
|
boolean |
hasXRogType() |
SrvMonIntSeries |
init()
Initialize an item.
|
boolean |
isBufferBacked() |
boolean |
isDirty() |
boolean |
isReferenceCounted() |
boolean |
isValid()
Tests if this object has any validation errors.
|
void |
lendIntervalStats(SrvMonIntHistogram val)
'Lends' a reference of the SrvMonIntHistogram to the message for this field.
|
void |
lendRunningStats(SrvMonIntHistogram val)
'Lends' a reference of the SrvMonIntHistogram to the message for this field.
|
static void |
optimizeFor(int val) |
byte[] |
serializeToByteArray() |
ByteBuffer |
serializeToByteBuffer() |
com.neeve.io.IOBuffer |
serializeToIOBuffer(boolean useNative) |
int |
serializeToNative(long address,
int addressOffset) |
void |
setAsReadOnly() |
void |
setDataPoints(int[] val)
Sets the value of 'dataPoints'.
|
void |
setDataPointsFrom(XIntIterator val)
Sets the value of 'dataPoints' using the values from the provided iterator.
|
static void |
setDesyncPolicy(com.neeve.xbuf.XbufDesyncPolicy val) |
static void |
setFieldInterest(List<Integer> fieldIds) |
void |
setIntervalStats(SrvMonIntHistogram val)
Sets the value of 'intervalStats'.
|
void |
setLastSequenceNumber(long val)
Sets the value of 'lastSequenceNumber'.
|
void |
setLastSequenceNumberAsObject(Long val)
Sets the value of 'lastSequenceNumber'.
|
void |
setLastSequenceNumberFrom(com.neeve.xbuf.XbufVariableLongField val) |
void |
setNumDataPoints(int val)
Sets the value of 'numDataPoints'.
|
void |
setNumDataPointsAsObject(Integer val)
Sets the value of 'numDataPoints'.
|
void |
setNumDataPointsFrom(com.neeve.xbuf.XbufVariableIntField val) |
SrvMonIntSeries |
setPool(UtlPool<SrvMonIntSeries> pool)
Set a pool item's pool.
|
void |
setPreserializedFields(PktBuffer buffer) |
void |
setRunningStats(SrvMonIntHistogram val)
Sets the value of 'runningStats'.
|
void |
setSkippedDatapoints(long val)
Sets the value of 'skippedDatapoints'.
|
void |
setSkippedDatapointsAsObject(Long val)
Sets the value of 'skippedDatapoints'.
|
void |
setSkippedDatapointsFrom(com.neeve.xbuf.XbufVariableLongField val) |
void |
setXRogType(short val) |
void |
setXRogTypeAsObject(Short val) |
void |
setXRogTypeFrom(com.neeve.xbuf.XbufVariableShortField val) |
void |
sync() |
void |
syncFieldBitmask() |
SrvMonIntHistogram |
takeIntervalStats()
'Takes' a reference to the intervalStats field from the message.
|
SrvMonIntHistogram |
takeRunningStats()
'Takes' a reference to the runningStats field from the message.
|
String |
toString() |
public static final SrvMonIntSeries[] EMPTY_ARRAY
public SrvMonIntSeries()
public SrvMonIntSeries(int initialBackingBufferSize)
public static SrvMonIntSeries create()
public static SrvMonIntSeries createFromSerializedXbufContainer(byte[] serializedContainer, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public static SrvMonIntSeries createFromSerializedXbufContainer(byte[] serializedContainer)
public static SrvMonIntSeries createFrom(byte[] serializedContainer, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public static SrvMonIntSeries createFrom(byte[] serializedContainer)
public static final void setDesyncPolicy(com.neeve.xbuf.XbufDesyncPolicy val)
public static final com.neeve.xbuf.XbufDesyncPolicy getDesyncPolicy()
public final void clearContent()
public final void syncFieldBitmask()
public final void desyncFieldBitmask()
public final PktBuffer getBackingBuffer()
public static final void optimizeFor(int val)
public final void setAsReadOnly()
public final boolean getIsReadOnly()
public final void setPreserializedFields(PktBuffer buffer)
public static final int getXRogTypeFieldId()
public final void setXRogType(short val)
public final void setXRogTypeAsObject(Short val)
public final short getXRogType()
public final Short getXRogTypeAsObject()
public final void setXRogTypeFrom(com.neeve.xbuf.XbufVariableShortField val)
public final com.neeve.xbuf.XbufVariableShortField getXRogTypeField()
public final boolean hasXRogType()
public final void clearXRogType()
public static final int getLastSequenceNumberFieldId()
public final void setLastSequenceNumber(long val)
ISrvMonIntSeriesSequence numbers for collected data points start at 1, a value of 0 indicates that no data points have been collected. The Sequence Number always indicates the number or data points that have been collected since the statistic has been created or was last reset. If the statistic is reset then this value will reset to 0, when
setLastSequenceNumber in interface ISrvMonIntSeriesval - The value to set.public final void setLastSequenceNumberAsObject(Long val)
ISrvMonIntSeriesSequence numbers for collected data points start at 1, a value of 0 indicates that no data points have been collected. The Sequence Number always indicates the number or data points that have been collected since the statistic has been created or was last reset. If the statistic is reset then this value will reset to 0, when
setLastSequenceNumberAsObject in interface ISrvMonIntSeriesval - The value to set.public final long getLastSequenceNumber()
ISrvMonIntSeriesSequence numbers for collected data points start at 1, a value of 0 indicates that no data points have been collected. The Sequence Number always indicates the number or data points that have been collected since the statistic has been created or was last reset. If the statistic is reset then this value will reset to 0, when
getLastSequenceNumber in interface ISrvMonIntSeriespublic final Long getLastSequenceNumberAsObject()
ISrvMonIntSeriesSequence numbers for collected data points start at 1, a value of 0 indicates that no data points have been collected. The Sequence Number always indicates the number or data points that have been collected since the statistic has been created or was last reset. If the statistic is reset then this value will reset to 0, when
getLastSequenceNumberAsObject in interface ISrvMonIntSeriespublic final void setLastSequenceNumberFrom(com.neeve.xbuf.XbufVariableLongField val)
public final com.neeve.xbuf.XbufVariableLongField getLastSequenceNumberField()
public final boolean hasLastSequenceNumber()
ISrvMonIntSeriesSequence numbers for collected data points start at 1, a value of 0 indicates that no data points have been collected. The Sequence Number always indicates the number or data points that have been collected since the statistic has been created or was last reset. If the statistic is reset then this value will reset to 0, when
hasLastSequenceNumber in interface ISrvMonIntSeriesISrvMonIntSeries.getLastSequenceNumber()public final void clearLastSequenceNumber()
ISrvMonIntSeriesSequence numbers for collected data points start at 1, a value of 0 indicates that no data points have been collected. The Sequence Number always indicates the number or data points that have been collected since the statistic has been created or was last reset. If the statistic is reset then this value will reset to 0, when
clearLastSequenceNumber in interface ISrvMonIntSeriesISrvMonIntSeries.setLastSequenceNumber(long)public static final int getNumDataPointsFieldId()
public final void setNumDataPoints(int val)
ISrvMonIntSeriesIndicates the number of data points collected in this interval. If no data points were collected numDataPoints will be 0. The sequence number of the first value collected in this interval can be determined by subtracting numDataPoints from lastSequenceNumber. This can be used to determine if two consecutive datapoints have skipped data points due to under sampling or a missing heartbeat.
setNumDataPoints in interface ISrvMonIntSeriesval - The value to set.public final void setNumDataPointsAsObject(Integer val)
ISrvMonIntSeriesIndicates the number of data points collected in this interval. If no data points were collected numDataPoints will be 0. The sequence number of the first value collected in this interval can be determined by subtracting numDataPoints from lastSequenceNumber. This can be used to determine if two consecutive datapoints have skipped data points due to under sampling or a missing heartbeat.
setNumDataPointsAsObject in interface ISrvMonIntSeriesval - The value to set.public final int getNumDataPoints()
ISrvMonIntSeriesIndicates the number of data points collected in this interval. If no data points were collected numDataPoints will be 0. The sequence number of the first value collected in this interval can be determined by subtracting numDataPoints from lastSequenceNumber. This can be used to determine if two consecutive datapoints have skipped data points due to under sampling or a missing heartbeat.
getNumDataPoints in interface ISrvMonIntSeriespublic final Integer getNumDataPointsAsObject()
ISrvMonIntSeriesIndicates the number of data points collected in this interval. If no data points were collected numDataPoints will be 0. The sequence number of the first value collected in this interval can be determined by subtracting numDataPoints from lastSequenceNumber. This can be used to determine if two consecutive datapoints have skipped data points due to under sampling or a missing heartbeat.
getNumDataPointsAsObject in interface ISrvMonIntSeriespublic final void setNumDataPointsFrom(com.neeve.xbuf.XbufVariableIntField val)
public final com.neeve.xbuf.XbufVariableIntField getNumDataPointsField()
public final boolean hasNumDataPoints()
ISrvMonIntSeriesIndicates the number of data points collected in this interval. If no data points were collected numDataPoints will be 0. The sequence number of the first value collected in this interval can be determined by subtracting numDataPoints from lastSequenceNumber. This can be used to determine if two consecutive datapoints have skipped data points due to under sampling or a missing heartbeat.
hasNumDataPoints in interface ISrvMonIntSeriesISrvMonIntSeries.getNumDataPoints()public final void clearNumDataPoints()
ISrvMonIntSeriesIndicates the number of data points collected in this interval. If no data points were collected numDataPoints will be 0. The sequence number of the first value collected in this interval can be determined by subtracting numDataPoints from lastSequenceNumber. This can be used to determine if two consecutive datapoints have skipped data points due to under sampling or a missing heartbeat.
clearNumDataPoints in interface ISrvMonIntSeriesISrvMonIntSeries.setNumDataPoints(int)public static final int getSkippedDatapointsFieldId()
public final void setSkippedDatapoints(long val)
ISrvMonIntSeriesThe runtime only holds on to a fixed number of data points for any particular statistic. If the sampling interval is too high then some datapoints may be skipped. For example let's say Latency stats are configured to hold on to a sample size of 1000 datapoints. If the number of data points being captured per second is 2000, and the stats collection interval is 1 second then on each collection, 1000 datapoints will be missed which will skew results. The skipped data points counter thus indicates how many datapoints have been missed in the reported runningStats. And if the count grows over two successive heartbeats indicates that the values the intervalStats don't reflect all the activity since the last interval. The skipped data points counter is a running counter ... it tracks the total number of data points that have been skipped since the underlying statistic was last reset.
setSkippedDatapoints in interface ISrvMonIntSeriesval - The value to set.public final void setSkippedDatapointsAsObject(Long val)
ISrvMonIntSeriesThe runtime only holds on to a fixed number of data points for any particular statistic. If the sampling interval is too high then some datapoints may be skipped. For example let's say Latency stats are configured to hold on to a sample size of 1000 datapoints. If the number of data points being captured per second is 2000, and the stats collection interval is 1 second then on each collection, 1000 datapoints will be missed which will skew results. The skipped data points counter thus indicates how many datapoints have been missed in the reported runningStats. And if the count grows over two successive heartbeats indicates that the values the intervalStats don't reflect all the activity since the last interval. The skipped data points counter is a running counter ... it tracks the total number of data points that have been skipped since the underlying statistic was last reset.
setSkippedDatapointsAsObject in interface ISrvMonIntSeriesval - The value to set.public final long getSkippedDatapoints()
ISrvMonIntSeriesThe runtime only holds on to a fixed number of data points for any particular statistic. If the sampling interval is too high then some datapoints may be skipped. For example let's say Latency stats are configured to hold on to a sample size of 1000 datapoints. If the number of data points being captured per second is 2000, and the stats collection interval is 1 second then on each collection, 1000 datapoints will be missed which will skew results. The skipped data points counter thus indicates how many datapoints have been missed in the reported runningStats. And if the count grows over two successive heartbeats indicates that the values the intervalStats don't reflect all the activity since the last interval. The skipped data points counter is a running counter ... it tracks the total number of data points that have been skipped since the underlying statistic was last reset.
getSkippedDatapoints in interface ISrvMonIntSeriespublic final Long getSkippedDatapointsAsObject()
ISrvMonIntSeriesThe runtime only holds on to a fixed number of data points for any particular statistic. If the sampling interval is too high then some datapoints may be skipped. For example let's say Latency stats are configured to hold on to a sample size of 1000 datapoints. If the number of data points being captured per second is 2000, and the stats collection interval is 1 second then on each collection, 1000 datapoints will be missed which will skew results. The skipped data points counter thus indicates how many datapoints have been missed in the reported runningStats. And if the count grows over two successive heartbeats indicates that the values the intervalStats don't reflect all the activity since the last interval. The skipped data points counter is a running counter ... it tracks the total number of data points that have been skipped since the underlying statistic was last reset.
getSkippedDatapointsAsObject in interface ISrvMonIntSeriespublic final void setSkippedDatapointsFrom(com.neeve.xbuf.XbufVariableLongField val)
public final com.neeve.xbuf.XbufVariableLongField getSkippedDatapointsField()
public final boolean hasSkippedDatapoints()
ISrvMonIntSeriesThe runtime only holds on to a fixed number of data points for any particular statistic. If the sampling interval is too high then some datapoints may be skipped. For example let's say Latency stats are configured to hold on to a sample size of 1000 datapoints. If the number of data points being captured per second is 2000, and the stats collection interval is 1 second then on each collection, 1000 datapoints will be missed which will skew results. The skipped data points counter thus indicates how many datapoints have been missed in the reported runningStats. And if the count grows over two successive heartbeats indicates that the values the intervalStats don't reflect all the activity since the last interval. The skipped data points counter is a running counter ... it tracks the total number of data points that have been skipped since the underlying statistic was last reset.
hasSkippedDatapoints in interface ISrvMonIntSeriesISrvMonIntSeries.getSkippedDatapoints()public final void clearSkippedDatapoints()
ISrvMonIntSeriesThe runtime only holds on to a fixed number of data points for any particular statistic. If the sampling interval is too high then some datapoints may be skipped. For example let's say Latency stats are configured to hold on to a sample size of 1000 datapoints. If the number of data points being captured per second is 2000, and the stats collection interval is 1 second then on each collection, 1000 datapoints will be missed which will skew results. The skipped data points counter thus indicates how many datapoints have been missed in the reported runningStats. And if the count grows over two successive heartbeats indicates that the values the intervalStats don't reflect all the activity since the last interval. The skipped data points counter is a running counter ... it tracks the total number of data points that have been skipped since the underlying statistic was last reset.
clearSkippedDatapoints in interface ISrvMonIntSeriesISrvMonIntSeries.setSkippedDatapoints(long)public static final int getDataPointsFieldId()
public static final com.neeve.xbuf.XbufRepeatedIntFieldBuffer createDataPointsFieldBuffer(int initialBufferLength,
boolean isNative)
For example the following would result in a bulk transfer from this message
XbufRepeatedIntFieldBuffer preallocated = SrvMonIntSeries.createDataPointsFieldBuffer(1024, true); // The following would then result in a buffer copy without any iteration: preallocated.setValue(inboundMessage.getDataPointsIterator()); // The preallocated bulk copied values can then be transfered to an outbound message: outboundMessage.setDataPoints.setValueFrom(preallocated);
Bulk transfer from the backing buffer may only possible between two fields with the same id (protobuf tag) because the bulk transfered bytes are in protobuf wire format which for most repeated fields encode the field's tag for each element.
initialBufferLength - the initial size of the underlying backing buffer.isNative - Whether the backing buffer should be a native or heap buffer.public final void setDataPoints(int[] val)
ISrvMonIntSeriesWhen the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored.
setDataPoints in interface ISrvMonIntSeriesval - The value to set.public final void setDataPointsFrom(XIntIterator val)
ISrvMonIntSeries
This method will call XIntIterator.toFirst() before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'dataPoints' accessor can copy the values without iteration.
When the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored.
NOTE:
Passing a null or empty iterator has the same affect as calling ISrvMonIntSeries.setDataPoints(int[]) with
a value of null.
setDataPointsFrom in interface ISrvMonIntSeriesval - the values to set.public final void addDataPoints(int val)
ISrvMonIntSeriesThis method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'dataPoints' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
When the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored.
addDataPoints in interface ISrvMonIntSeriesval - the value to add.public final int[] getDataPoints()
ISrvMonIntSeries
If the field is not set this method will return null.
When the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored.
getDataPoints in interface ISrvMonIntSeriesnull.public final int[] getDataPointsEmptyIfNull()
ISrvMonIntSeriesnull or not set.
When the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored.
getDataPointsEmptyIfNull in interface ISrvMonIntSeriesnull if not set.ISrvMonIntSeries.getDataPoints()public final XIntIterator getDataPointsIterator()
ISrvMonIntSeriesThis method will always return a non null iterator value. The returned iterator is not threadsafe, and the caller may not hold on to it beyond the pooling lifespan of this object. Depending on the implementation, the same iterator instance may be returned by this object on each call to avoid garbage. Each time this method is called the iterator is reset by calling its toFirst() method. Callers should therefore be especially careful about calling this method while iterating on the iterator returned by this method.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that
passing the returned iterator to another object's setXXX(com.neeve.lang.XIntIterator) method
can perform a direct copy of the underlying values without iteration.
When the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored.
getDataPointsIterator in interface ISrvMonIntSeriespublic final void clearDataPoints()
ISrvMonIntSeriesWhen the XVM is configured to include the capture data points for the statistic, the returned array will include the values collected during this interval. This allows monitoring tools to perform non lossy calculation of percentiles providing now data points were skipped due to under sampling or a missed heartbeat. Then number of valid values in the returned array is dictated by numDataPoints, if the length of the values array is longer than numDataPoints subsequent values in the array should be ignored.
clearDataPoints in interface ISrvMonIntSeriesISrvMonIntSeries.setDataPoints(int[])public static final int getIntervalStatsFieldId()
public final void setIntervalStats(SrvMonIntHistogram val)
ISrvMonIntSeriesHold computed results for the datpoints captured for this heartbeat (e.g. for the numDataPoints captured). This field may not be set if numDataPoints is 0 or if interval computations are not done on the XVM.
setIntervalStats in interface ISrvMonIntSeriesval - The value to set.public final void lendIntervalStats(SrvMonIntHistogram val)
ISrvMonIntSeriesHold computed results for the datpoints captured for this heartbeat (e.g. for the numDataPoints captured). This field may not be set if numDataPoints is 0 or if interval computations are not done on the XVM.
NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message.
This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().
To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.
lendIntervalStats in interface ISrvMonIntSeriesval - the value to 'lend' to lend.public final SrvMonIntHistogram getIntervalStats()
ISrvMonIntSeriesHold computed results for the datpoints captured for this heartbeat (e.g. for the numDataPoints captured). This field may not be set if numDataPoints is 0 or if interval computations are not done on the XVM.
getIntervalStats in interface ISrvMonIntSeriespublic final void getIntervalStatsTo(SrvMonIntHistogram to)
ISrvMonIntSeriesIF the value is not set, then the contents of the provided SrvMonIntHistogram are cleared.
getIntervalStatsTo in interface ISrvMonIntSeriesto - the value to copy intoSrvMonIntHistogram.copyInto(SrvMonIntHistogram)public final SrvMonIntHistogram takeIntervalStats()
ISrvMonIntSeriesHold computed results for the datpoints captured for this heartbeat (e.g. for the numDataPoints captured). This field may not be set if numDataPoints is 0 or if interval computations are not done on the XVM.
NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed
i.e. the act of getting an entity does not transfer ownership of the entity to the application
A message disposes of its reference to its contained entities when it is disposed itself.
An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.
takeIntervalStats in interface ISrvMonIntSeriesnull if the field is not set.public final boolean hasIntervalStats()
ISrvMonIntSeriesHold computed results for the datpoints captured for this heartbeat (e.g. for the numDataPoints captured). This field may not be set if numDataPoints is 0 or if interval computations are not done on the XVM.
hasIntervalStats in interface ISrvMonIntSeriesISrvMonIntSeries.getIntervalStats()public final void clearIntervalStats()
ISrvMonIntSeriesHold computed results for the datpoints captured for this heartbeat (e.g. for the numDataPoints captured). This field may not be set if numDataPoints is 0 or if interval computations are not done on the XVM.
clearIntervalStats in interface ISrvMonIntSeriesISrvMonIntSeries.setIntervalStats(SrvMonIntHistogram)public static final int getRunningStatsFieldId()
public final void setRunningStats(SrvMonIntHistogram val)
ISrvMonIntSeriesHold computed results for the datpoints over the lifetime of this statistics (e.g. since seqNo 1). If the underlying statistic is reset then the running stats are also corresponding reset.
setRunningStats in interface ISrvMonIntSeriesval - The value to set.public final void lendRunningStats(SrvMonIntHistogram val)
ISrvMonIntSeriesHold computed results for the datpoints over the lifetime of this statistics (e.g. since seqNo 1). If the underlying statistic is reset then the running stats are also corresponding reset.
NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message.
This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().
To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.
lendRunningStats in interface ISrvMonIntSeriesval - the value to 'lend' to lend.public final SrvMonIntHistogram getRunningStats()
ISrvMonIntSeriesHold computed results for the datpoints over the lifetime of this statistics (e.g. since seqNo 1). If the underlying statistic is reset then the running stats are also corresponding reset.
getRunningStats in interface ISrvMonIntSeriespublic final void getRunningStatsTo(SrvMonIntHistogram to)
ISrvMonIntSeriesIF the value is not set, then the contents of the provided SrvMonIntHistogram are cleared.
getRunningStatsTo in interface ISrvMonIntSeriesto - the value to copy intoSrvMonIntHistogram.copyInto(SrvMonIntHistogram)public final SrvMonIntHistogram takeRunningStats()
ISrvMonIntSeriesHold computed results for the datpoints over the lifetime of this statistics (e.g. since seqNo 1). If the underlying statistic is reset then the running stats are also corresponding reset.
NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed
i.e. the act of getting an entity does not transfer ownership of the entity to the application
A message disposes of its reference to its contained entities when it is disposed itself.
An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.
takeRunningStats in interface ISrvMonIntSeriesnull if the field is not set.public final boolean hasRunningStats()
ISrvMonIntSeriesHold computed results for the datpoints over the lifetime of this statistics (e.g. since seqNo 1). If the underlying statistic is reset then the running stats are also corresponding reset.
hasRunningStats in interface ISrvMonIntSeriesISrvMonIntSeries.getRunningStats()public final void clearRunningStats()
ISrvMonIntSeriesHold computed results for the datpoints over the lifetime of this statistics (e.g. since seqNo 1). If the underlying statistic is reset then the running stats are also corresponding reset.
clearRunningStats in interface ISrvMonIntSeriesISrvMonIntSeries.setRunningStats(SrvMonIntHistogram)public final boolean isDirty()
public static final com.neeve.xbuf.XbufSchema createSchema()
public final byte[] serializeToByteArray()
public final ByteBuffer serializeToByteBuffer()
public final com.neeve.io.IOBuffer serializeToIOBuffer(boolean useNative)
public final boolean isBufferBacked()
public final int getSerializeToNativeLength()
public final int serializeToNative(long address,
int addressOffset)
public final SrvMonIntSeries deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer, int offset, int length, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonIntSeries deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer, int offset, int length)
public final SrvMonIntSeries deserializeFromByteArray(byte[] array, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonIntSeries deserializeFromByteArray(byte[] array)
public final SrvMonIntSeries deserializeFromByteBuffer(ByteBuffer buffer, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonIntSeries deserializeFromByteBuffer(ByteBuffer buffer)
public final SrvMonIntSeries deserializeFromNative(long address, int offset, int length, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonIntSeries deserializeFromNative(long address, int offset, int length)
public final void sync()
public final int desync(PktBuffer buffer, int pos, boolean frameOnly)
com.neeve.xbuf.IXbufDesyncerdesync in interface com.neeve.xbuf.IXbufDesyncerbuffer - The buffer to desync frompos - The position in the container's backing buffer to desync
fromframeOnly - Whether to frame the field on the underlying buffer.
See XbufField.desync(PktBuffer, int, boolean) for more
informationpublic final SrvMonIntSeries init()
UtlPool.ItemThis method is invoked by an item pool very time an item is put into the pool. The method should wipe the contents of the item so as to present a fresh instance of the item to the caller when retrieved from the pool.
init in interface UtlPool.Item<SrvMonIntSeries>public final SrvMonIntSeries setPool(UtlPool<SrvMonIntSeries> pool)
UtlPool.ItemThis method is invoked by an item pool at the time an item is added to the pool. The intent is to record the item's source pool in the item so it can be disposed back into the pool when the user is done working with it.
setPool in interface UtlPool.Item<SrvMonIntSeries>public final UtlPool<SrvMonIntSeries> getPool()
UtlPool.Item
This method should return the pool set using UtlPool.Item.setPool(com.neeve.util.UtlPool<T>)
getPool in interface UtlPool.Item<SrvMonIntSeries>UtlPool.Item.setPool(com.neeve.util.UtlPool<T>)public final boolean isReferenceCounted()
public final SrvMonIntSeries acquire()
public final int getOwnerCount()
public final void dispose()
public final Object clone()
This method differs from the copy() method in that:
public final SrvMonIntSeries copy()
The copy copies primitive, enum and embedded entity fields into the returned copy. Each embedded entity field is cloned so that modifications made to the copy's embedded entity fields do not affect this SrvMonIntSeries's embedded entity fields.
The returned copy will be writeable even if this SrvMonIntSeries is read only.
public final void copyInto(SrvMonIntSeries copy)
The copy clears the target's contents and copies primitive, enum and embedded entity fields into the provided copy. Each embedded entity field is cloned so that modifications made to the copy's embedded entity fields do not affect this SrvMonIntSeries's embedded entity fields.
The returned copy will be writeable even if this SrvMonIntSeries is read only.
copy - The target into which to copy.public final boolean isValid()
IRogValidatableisValid in interface IRogValidatablepublic final void getValidationErrors(List<XString> results, String errorPrefix)
IRogValidatablegetValidationErrors in interface IRogValidatableresults - A results list into which validation errors will be collected.errorPrefix - The bean path prefix to use when identifying invalid fields or null if validating a top level entity.Copyright © 2019 Neeve Research, LLC. All Rights Reserved.