- ems:metric resources that lack pm:metricQualifier are allowed. They may signal qualification that is implicit from the context.
- If a Performance Monitoring provider exposes any of the metrics below, they MUST be mapped to ems:Measure resources as shown. Other predicates MAY be present, for example dcterms:title; their values are not constrained by the mapping below. Other values of the predicates shown below MAY also be present within the constraints of the resource definition, for example additional qualifier values or RDF types.
| Quantity exposed |
ems:numericValue |
rdf:type |
ems:metric |
pm:metricQualifier |
ems:unitOfMeasure |
| Section: Resource usage/consumption metrics |
|
|
|
|
|
| CPU Utilization |
10 |
ems:Measure |
pm:ResourceUsage |
pm:CPU
pm:Utilization |
dbp:Percentage |
| Virtual Memory Utilization |
50 |
ems:Measure |
pm:ResourceUsage |
pm:Virtual
pm:Memory |
dbp:Percentage |
| Real Memory Utilization |
50 |
ems:Measure |
pm:ResourceUsage |
pm:Real
pm:Memory |
dbp:Percentage |
| Percentage Disk Space Used |
50 |
ems:Measure |
pm:ResourceUsage |
pm:Disk |
dbp:Percentage |
| Heap Usage |
52 |
ems:Measure |
pm:ResourceUsage |
pm:Heap |
dbp:Percentage |
| % Buffer Pool Used |
45 |
ems:Measure |
pm:ResourceUsage |
pm:BufferPool |
dbp:Percentage |
|
|
|
|
|
|
| Percentage of Time Thread Pool Maxed |
2 |
ems:Measure |
pm:ResourceExhausted |
pm:ThreadPool |
dbp:Percentage |
| Percentage of Time JCA Thread Pool Maxed |
5 |
ems:Measure |
pm:ResourceExhausted |
pm:ThreadPool
pm:JCA |
dbp:Percentage |
| Percentage of Time DB Thread Pool Maxed |
21 |
ems:Measure |
pm:ResourceExhausted |
pm:ThreadPool
pm:Database |
dbp:Percentage |
| Percentage by which space allocated over-commits a Disk |
150 |
ems:Measure |
pm:ResourceExhausted |
pm:Disk |
dbp:Percentage |
|
|
|
|
|
|
| Section: Available resource metrics |
|
|
|
|
|
| Percentage Free Memory After Garbage Collection |
32 |
ems:Measure |
pm:ResourceAvailable |
pm:Virtual
pm:Memory |
dbp:Percentage |
| VM CPU Percent Ready |
56 |
ems:Measure |
pm:ResourceAvailable |
pm:CPU
pm:Virtual |
dbp:Percentage |
| CPU Speed |
1024 |
ems:Measure |
pm:ResourceAvailable |
pm:CPU |
qudt:Hertz |
|
|
|
|
|
|
| Section: Request metrics |
|
|
|
|
|
| Average Login Request Failure Rate |
10.5 |
ems:Measure |
pm:Request |
pm:Login
pm:Failure
pm:Average |
qudt:PerSecond |
| Average Login Request Failures Per Minute |
2.4 |
ems:Measure |
pm:Request |
pm:Login
pm:Average |
pm:PerMinute |
| Number of failed SQL Statements |
310 |
ems:Measure |
pm:Request |
pm:SQL
pm:Failure |
qudt:Unitless |
| Garbage Collection Count |
72787723 |
ems:Measure |
pm:Request |
pm:GarbageCollection |
dbp:Count_data |
| Request Failure Rate Per Minute |
25.3 |
ems:Measure |
pm:Request |
pm:Failure |
pm:PerMinute |
| Request Failure Count |
45911 |
ems:Measure |
pm:Request |
pm:Failure |
dbp:Count_data |
| Request Rate Per Second |
1339.2 |
ems:Measure |
pm:Request |
no qualifier value |
qudt:PerSecond |
|
|
|
|
|
|
| Section: Response time metrics |
|
|
|
|
|
| Response Time |
4.500 |
ems:Measure |
dbp:Response_time_(technology) |
|
qudt:Second |
| Average JMS Get Time |
3.000 |
ems:Measure |
pm:Request |
pm:JMS
pm:Get
pm:Average |
qudt:Second |
|
|
|
|
|
|
|
|
ems:Measure |
|
|
|
Table above in RDF
@prefix pm: <http://open-services.net/ns/perfmon#> .
@prefix oslc: <http://open-services.net/ns/core#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix dcterms: <http://purl.org/dc/terms/> .
@prefix ex: <http://example.org#> .
@prefix ems: <http://open-services.net/ns/ems#> .
@prefix crtv: <http://open-services.net/ns/crtv#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix bp: <http://open-services.net/ns/basicProfile#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>.
@base <http://perfmon-provider.example.org/> .
# Intent is to match table at http://open-services.net/wiki/performance-monitoring/OSLC-Performance-Monitoring-2.0-Appendix-A:-Samples/
<rec001> # a record instance
a pm:PerformanceMonitoringRecord ;
# see http://open-services.net/bin/view/Main/MetricsEmsMeasure?sortcol=table;up=#Properties
# for how SWProjMgmtWG defines a single metric value
# see http://open-services.net/bin/view/Main/MetricsEMS10RestApiStandardUris?sortcol=table;up=#ems_Metric
# for existing ems:metric values defined by SWProjMgmtWG
ems:observes <rec001#cpuutil10> ;
ems:observes <rec001#virtmemutil50> ;
ems:observes <rec001#realmemutil50> ;
ems:observes <rec001#diskspace50> ;
#
ems:observes <rec001#threadpoolmaxed02> ;
ems:observes <rec001#jcathreadpoolmaxed05> ;
#
ems:observes <rec001#postgcfreemem32> ;
ems:observes <rec001#cpuspeed1024> ;
#
ems:observes <rec001#avgloginreqfailure10.5> ;
ems:observes <rec001#avgloginfailsperminute2.4> ;
ems:observes <rec001#numfailedsqlstmts310> ;
#
ems:observes <rec001#resptime4.500> ;
ems:observes <rec001#avgjmsgettime3.000> ;
# ems:observes <rec001#> ;
#
pm:collectedAt "2012-06-13T19:48:09.5Z" ;
#
# Link perf mon record to CS. They might be separate records, but in this ex they are the same record.
dcterms:isPartOf <recCS001> ; # link to another resource
# NO time zone on following implementation-specific extension property
# This is legal in xsd:dateTime, but not great for interop
ex:aLocalTime "2002-05-30T09:30:10.5" ;
ex:fooBar 0;
.
#
<rec001#cpuutil10>
a ems:Measure ; # rdf:type
dcterms:title "CPU Utilization" ;
ems:metric <pm:ResourceUsage> ;
pm:metricQualifier <pm:CPU> ;
pm:metricQualifier <pm:Utilization> ;
ems:unitOfMeasure <dbp:Percentage> ;
ems:numericValue 10 ;
.
#
<rec001#virtmemutil50>
a ems:Measure ; # rdf:type
dcterms:title "Virtual Memory Utilization" ;
ems:metric <pm:ResourceUsage> ;
pm:metricQualifier <pm:Virtual> ;
pm:metricQualifier <pm:Memory> ;
pm:metricQualifier <pm:Utilization> ; # add to wiki
ems:unitOfMeasure <dbp:Percentage> ;
ems:numericValue 50 ;
.
#
<rec001#realmemutil50>
a ems:Measure ; # rdf:type
dcterms:title "Real Memory Utilization" ;
ems:metric <pm:ResourceUsage> ;
pm:metricQualifier <pm:Real> ;
pm:metricQualifier <pm:Memory> ;
pm:metricQualifier <pm:Utilization> ; # add to wiki
ems:unitOfMeasure <dbp:Percentage> ;
ems:numericValue 50 ;
.
#
<rec001#diskspace50>
a ems:Measure ; # rdf:type
dcterms:title "Percentage Disk Space Used" ;
ems:metric <pm:ResourceUsage> ;
pm:metricQualifier <pm:Disk> ;
ems:unitOfMeasure <dbp:Percentage> ;
ems:numericValue 50 ;
.
#
<rec001#threadpoolmaxed02>
a ems:Measure ; # rdf:type
dcterms:title "Percentage of Time Thread Pool Maxed" ;
ems:metric <pm:ResourceExhausted> ;
pm:metricQualifier <pm:ThreadPool> ;
ems:unitOfMeasure <dbp:Percentage> ;
ems:numericValue 2 ;
.
#
<rec001#jcathreadpoolmaxed05>
a ems:Measure ; # rdf:type
dcterms:title "Percentage of Time JCA Thread Pool Maxed" ;
ems:metric <pm:ResourceExhausted> ;
pm:metricQualifier <pm:ThreadPool> ;
pm:metricQualifier <pm:JCA> ;
ems:unitOfMeasure <dbp:Percentage> ;
ems:numericValue 5 ;
.
#
<rec001#postgcfreemem32>
a ems:Measure ; # rdf:type
dcterms:title "Percentage Free Memory After Garbage Collection" ;
ems:metric <pm:ResourceAvailable> ;
pm:metricQualifier <pm:Virtual> ;
pm:metricQualifier <pm:Memory> ;
ems:unitOfMeasure <dbp:Percentage> ;
ems:numericValue 32 ;
.
#
<rec001#cpuspeed1024>
a ems:Measure ; # rdf:type
dcterms:title "CPU Speed" ;
ems:metric <pm:ResourceAvailable> ;
pm:metricQualifier <pm:CPU> ;
ems:unitOfMeasure <qudt:Hertz> ;
ems:numericValue 1024 ;
.
#
<rec001#avgloginreqfailure10.5>
a ems:Measure ; # rdf:type
dcterms:title "Average Login Request Failure Rate" ;
ems:metric <pm:Request> ;
pm:metricQualifier <pm:Login> ;
pm:metricQualifier <pm:Failure> ;
pm:metricQualifier <pm:Average> ;
ems:unitOfMeasure <qudt:PerSecond> ;
ems:numericValue 10.5 ;
.
#
<rec001#avgloginfailsperminute2.4>
a ems:Measure ; # rdf:type
dcterms:title "Average Login Request Failures Per Minute" ;
ems:metric <pm:Request> ;
pm:metricQualifier <pm:Login> ;
pm:metricQualifier <pm:Failure> ; # add to wiki
pm:metricQualifier <pm:Average> ;
ems:unitOfMeasure <pm:pm:PerMinute> ;
ems:numericValue 2.4 ;
.
#
<rec001#numfailedsqlstmts310>
a ems:Measure ; # rdf:type
dcterms:title "Number of failed SQL Statements" ;
ems:metric <pm:Request> ;
pm:metricQualifier <pm:SQL> ;
pm:metricQualifier <pm:Failure> ;
ems:unitOfMeasure <pm:dbp:Count_data> ; # fix on wiki
ems:numericValue 310 ;
.
#
<rec001#resptime4.500>
a ems:Measure ; # rdf:type
dcterms:title "Response Time" ;
ems:metric <dbp:Response_time_(technology)> ;
# pm:metricQualifier <pm:> ;
ems:unitOfMeasure <qudt:Second> ;
ems:numericValue 4.500 ;
.
#
<rec001#avgjmsgettime3.000>
a ems:Measure ; # rdf:type
dcterms:title "Average JMS Get Time" ;
ems:metric <dbp:Response_time_(technology)> ; # fix on wiki
pm:metricQualifier <pm:JMS> ;
pm:metricQualifier <pm:Get> ;
pm:metricQualifier <pm:Average> ;
ems:unitOfMeasure <qudt:Second> ;
ems:numericValue 3.000 ;
.
#
#<rec001#>
# a ems:Measure ; # rdf:type
# dcterms:title "" ;
# ems:metric <pm:> ; # pm:New... means a new definition is needed
# pm:metricQualifier <pm:> ;
# ems:unitOfMeasure <pm:> ;
# ems:numericValue 80 ;
#.
ITM Example - using fenced code blocks, see advanced syntax
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:oslc="http://open-services.net/ns/core#"
xmlns:crtv="http://open-services.net/ns/crtv#"
xmlns:dcterms="http://purl.org/dc/terms/"
xmlns:ems="http://open-services.net/ns/ems#"
xmlns:pm="http://open-services.net/ns/perfmon#"
xmlns:dbpedia="http://dbpedia.org"
xmlns:foaf="http://xmlns.com/foaf/0.1/">
ITM Example - original from 2012-09-25
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:oslc="http://open-services.net/ns/core#"
xmlns:crtv="http://open-services.net/ns/crtv#"
xmlns:dcterms="http://purl.org/dc/terms/"
xmlns:ems="http://open-services.net/ns/ems#"
xmlns:pm="http://open-services.net/ns/perfmon#"
xmlns:dbpedia="http://dbpedia.org"
xmlns:foaf="http://xmlns.com/foaf/0.1/">
<rdf:Description rdf:about="http://itmprovider.org/rec001">
<rdf:type rdf:resource="http://open-services.net/ns/crtv#ComputerSystem"/>
<!-- Computer System naming properties -->
<crtv:manufacturer>IBM</crtv:manufacturer>
<crtv:model>2007CTO</crtv:model>
<crtv:serialNumber>LG3G3K2</crtv:serialNumber>
<crtv:fqdn>
maxwell.raleigh.ibm.com
</crtv:fqdn>
<oslc:serviceProvider>
itmprovider.org
</oslc:serviceProvider>
<dcterms:date>2012-06-13T19:48:09.5Z</dcterms:date>
<!-- Tells client there are performance metrics associated with ComputerSystem -->
<rdf:type rdf:resource="http://open-services.net/ns/perfmon#PerformanceMonitoringRecord"/>
<!-- Processes -->
<pm:process rdf:resource="http://itmprovider.org/rec001#iexplore.exe"/>
<!-- Disks -->
<pm:disk rdf:resource="http://itmprovider.org/rec001#disk1"/>
<pm:disk rdf:resource="http://itmprovider.org/rec001#disk2"/>
<!-- Agents -->
<pm:monitoringAgent rdf:resource="http://itmprovider.org/rec001#knt"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#disk1">
<rdf:type rdf:resource="http://open-services.net/ns/crtv#StorageVolume"/>
<dcterms:title>
C:\
</dcterms:title>
<ems:observes rdf:resource="http://itmprovider.org/rec001#disk1_spaceused"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#disk1_spaceused">
<rdf:type rdf:resource="http://open-services.net/ns/ems#Measure"/>
<dcterms:title>
Percentage Space Used
</dcterms:title>
<ems:metric rdf:resource="http://open-services.net/ns/perfmon#PercentageSpaceUsed"/>
<ems:numericValue rdf:datatype="http://www.w3.org/2001/XMLSchema#double">
30
</ems:numericValue>
<ems:unitOfMeasure rdf:resource="http://dbpedia.org/Percentage"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#disk2">
<rdf:type rdf:resource="http://open-services.net/ns/crtv#StorageVolume"/>
<dcterms:title>
D:\
</dcterms:title>
<ems:observes rdf:resource="http://itmprovider.org/rec001#disk2_spaceused"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#disk2_spaceused">
<rdf:type rdf:resource="http://open-services.net/ns/ems#Measure"/>
<dcterms:title>
Percentage Space Used
</dcterms:title>
<ems:metric rdf:resource="http://open-services.net/ns/perfmon#PercentageSpaceUsed"/>
<ems:numericValue rdf:datatype="http://www.w3.org/2001/XMLSchema#double">
20
</ems:numericValue>
<ems:unitOfMeasure rdf:resource="dbpedia.org/Percentage"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#iexplore">
<rdf:type rdf:resource="http:open-services.net/ns/crtv#Process"/>
<dcterms:title>
iexplore.exe
</dcterms:title>
<ems:observes rdf:resource="http://itmprovider.org/rec001#iexplore-virtMem"/>
<ems:observes rdf:resource="http://itmprovider.org/rec001#iexplore-realMem"/>
<ems:observes rdf:resource="http://itmprovider.org/rec001#iexplore-cpuUtil"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#iexplore-virtMem">
<rdf:type rdf:resource="http://open-services.net/ns/ems#Measure"/>
<dcterms:title>
Virtual Memory Utilization
</dcterms:title>
<ems:metric rdf:resource="http://open-services.net/ns/perfmon#VirtualMemoryUtilization"/>
<ems:numericValue rdf:datatype="http://www.w3.org/2001/XMLSchema#double">
10
</ems:numericValue>
<ems:unitOfMeasure rdf:resource="http://dbpedia.org/Percentage"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#iexplore-realMem">
<rdf:type rdf:resource="http://open-services.net/ns/ems#Measure"/>
<dcterms:title>
Real Memory Utilization
</dcterms:title>
<ems:metric rdf:resource="http://open-services.net/ns/perfmon#RealMemoryUtilization"/>
<ems:numericValue rdf:datatype="http://www.w3.org/2001/XMLSchema#double">
5
</ems:numericValue>
<ems:unitOfMeasure rdf:resource="http://dbpedia.org/Percentage"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#iexplore-cpuUtil">
<rdf:type rdf:resource="http://open-services.net/ns/ems#Measure"/>
<dcterms:title>
CPU Utilization
</dcterms:title>
<ems:metric rdf:resource="http://open-services.net/ns/perfmon#CPUUtilization"/>
<ems:numericValue rdf:datatype="http://www.w3.org/2001/XMLSchema#double">
5
</ems:numericValue>
<ems:unitOfMeasure rdf:resource="http://dbpedia.org/Percentage"/>
</rdf:Description>
<rdf:Description rdf:about="http://itmprovider.org/rec001#knt">
<rdf:type rdf:resource="http://xmlns.com/foaf/0.1/Agent"/>
<dcterms:title>
Windows OS Agent
</dcterms:title>
<pm:availabilityStatus rdf:resource="http://open-services.net/ns/perfmon#NotRunning"/>
</rdf:Description>
</rdf:RDF>
