From 60da1860de76b92fcccbaa48cee29836bbccb415 Mon Sep 17 00:00:00 2001
From: Simon Crowle <sgc@it-innovation.soton.ac.uk>
Date: Wed, 10 Jan 2018 17:10:56 +0000
Subject: [PATCH] Adds preliminary monitoring for basic scenario

---
 ...ring specification for a basic scenario.md | 140 ++++++++++++++++++
 1 file changed, 140 insertions(+)
 create mode 100644 docs/CLMC monitoring specification for a basic scenario.md

diff --git a/docs/CLMC monitoring specification for a basic scenario.md b/docs/CLMC monitoring specification for a basic scenario.md
new file mode 100644
index 0000000..a8afea6
--- /dev/null
+++ b/docs/CLMC monitoring specification for a basic scenario.md	
@@ -0,0 +1,140 @@
+# CLMC monitoring specification for a basic scenario
+
+## CONFIGURATION: SLICE
+### Compute node configuration
+
+#### Common context
+| measurement | tag |
+| --- | --- | --- |
+| compute_node_config, | slice_id="SLICE1" | 
+
+#### Specific context
+| tag | tag | field | field | field | timestamp |
+| --- | --- | --- | --- | --- | --- |
+| location='DC1', | comp_node_id='c1' | cpus=4, | memory=8, | storage=16 | 1515583926868000000 |
+
+### Network configuration
+__MORE NEEDED FROM IDE__
+
+#### Common context: VLANs
+| measurement | tag |
+| --- | --- | --- |
+| network_resource_config,| slice_id='SLICE1' |
+
+#### Specific context: VLANs
+| tag | field | timestamp |
+| --- | --- | --- | --- | --- | --- |
+| network_id="VNET1" | bandwidth=400 | 1515583926868000000 |
+
+#### Common context: Network interfaces
+| measurement | tag |
+| --- | --- | --- |
+| network_interface_config,| slice_id='SLICE1' |
+
+| tag | tag | field | field | timestamp |
+| --- | --- | --- | --- | --- | --- |
+| comp_node_id='c1', | port_id='enps03', | rx_constraint=1000, | tx_constraint=1000 | 1515583926868000000 |
+
+
+
+## CONFIGURATION: SF template (TOSCA)
+### Media Service SFC states
+__MORE NEEDED FROM IDE__
+
+
+### CONFIGURATION: Media Service SF Instance states
+__MORE NEEDED FROM IDE__
+
+
+### CONFIGURATION: Media Service SF Instance Surrogate states
+
+#### Common context
+|measurement|tag|tag|tag|tag|tag|
+| --- | --- | --- | --- | --- | --- |
+| sf_instance_surrogate_config, | location="DC1", | sfc="Scenario1_Template", | sfc_i="Scenario1_Template_I1", | sf_package="MS_STREAMING", | sf_i="MS_STREAMING_1" | 
+
+#### Specific context
+|field|field|field|timestamp|
+| --- | --- | --- | --- | --- |
+| cpus=2, | memory=4, | storage=8 | 1515583926868000000 |
+
+
+## Monitor Service Function Instance Surrogate (VMs)
+#### Common context: Usage and Performance
+All of the specific context measurements below carry the following common context (this has not be replicated for brevity) for both usage and performance measurements. In this example, we illustrate using 2 surrogate VMs.
+
+| measurement | tag | tag | tag | tag | tag |
+| --- | --- | --- | --- | --- | --- | --- |
+| \<measurement>, | location="DC1", | sfc="Scenario1_Template", | sfc_i="Scenario1_Template_I1", | sf_package="MS_STREAMING", | sf_i="MS_STREAMING_1", | vm_instance ="MPEG_DASH_Server1" |
+| \<measurement>, | location="DC2", | sfc="Scenario1_Template", | sfc_i="Scenario1_Template_I1", | sf_package="MS_STREAMING", | sf_i="MS_STREAMING_2", | vm_instance ="MPEG_DASH_Server2" |
+
+Also NOTE: the metrics provided in the measurements below are effectively a 'snapshot' of usage over a relatively small period of time. The length of this snapshot may vary, depending on the underlying implementation of the instrumentation, so we might have to assume this snapshot is close to 'instant'. 
+
+### USAGE: Monitor Service Function Instance Surrogate (VMs)
+#### Specific context: CPU usage
+| measurement | \<common tags> | field | field | timestamp |
+| --- | --- | --- | --- | --- |
+| vm_host_cpu_usage | \<common tags> | cpu_usage=40, | cpu_usage_system=5 | 1515583926868000000 |
+
+##### Specific context: RAM usage
+| measurement | \<common tags> | field | field | timestamp |
+| --- | --- | --- | --- | --- | --- |
+| vm_host_ram_usage | \<common tags> | ram_usage=1400, | ram_usage_system=512, | 1515583926868000000 |
+
+##### Specific context: storage usage
+| measurement | \<common tags> | field | field | timestamp |
+| --- | --- | --- | --- | --- | --- | --- |
+| vm_host_storage_usage | \<common tags> | disk_free=8144, | swap_size=1576 | 1515583926868000000 |
+
+##### Specific context: network usage
+
+> Not sure about this one. For example: Bytes over port_M - is this a total byte count that increments over time
+> or is it a snapshot shot of throughput on port M over the course of, say, 1 second?
+
+| measurement | \<common tags> | field | field | timestamp |
+| --- | --- | --- | --- | --- | --- |
+| vm_host_network_usage | \<common tags> | rx_bytes_port_M=5242880, | tx_bytes_port_M=15728640 | 1515583926868000000 |
+
+
+### PERFORMANCE: Monitor Service Function Instance Surrogate (VMs)
+Note all metrics described below are assumed to be *averages* over 1 second.
+
+#### Specific context: CPU performance
+| measurement | \<common tags> | field | timestamp |
+| --- | --- | --- | --- | --- |
+| vm_host_cpu_perf | \<common tags> | idle_seconds=0.5 | 1515583926868000000 |
+
+#### Specific context: RAM performance
+| measurement | \<common tags> | field | timestamp |
+| --- | --- | --- | --- | --- |
+| vm_host_ram_perf | \<common tags> | swap_memory_used | 1515583926868000000 |
+
+#### Specific context: storage performance
+| measurement | \<common tags> | field | field | timestamp |
+| --- | --- | --- | --- | --- |
+| vm_host_storage_perf | \<common tags> | read_bytes=4194304, | write_bytes=2097152 | 1515583926868000000 |
+
+#### Specific context: network performance
+| measurement | \<common tags> | field | field | field | field | timestamp |
+| --- | --- | --- | --- | --- | --- | --- |
+| vm_host_network_perf | \<common tags> | rx_bytes_port_M=4194, | tx_bytes_port_M=2097, | packets_dropped=198, | packets_error=5 | 1515583926868000000 |
+
+
+### USAGE: Service Function Instance Surrogate Service usage 
+
+#### Common context
+| measurement | tag | tag | tag | tag | tag | tag |
+| --- | --- | --- | --- | --- | --- | --- |
+| \<measurement label> | location="DC1", | sfc="Scenario1_Template", | sfc_i="Scenario1_Template_I1", | sf_package="MS_STREAMING", | sf_i="MS_STREAMING_1", | vm_instance ="MPEG_DASH_Server1" | 
+
+#### Request (WIP)
+| measurement | \<common tags> | tag | timestamp |
+| --- | --- | --- | --- | --- | --- | --- |
+| mpegdash_service_request | \<common tags> | cont_nav='http://netflix.com/scream' | 1515583926868000000 |
+
+#### Response (WIP)
+
+
+
+### PERFORMANCE: Service Function Instance Surrogate VM Service performance (KPIs)
+
-- 
GitLab