.. -*- rst -*-

===========================
Prometheus Plugin Interface
===========================

This interface is used for notifying alert that is detected by
the External Monitoring Tool. The External Monitoring Tool is
Prometheus based Monitoring system.

The Prometheus Plugin has 3 functions:

- Alerting interface for ETSI NFV-SOL 002/003 based Performance Management.
- Alerting interface for ETSI NFV-SOL 002/003 based Fault Management.
- Alerting interface for Prometheus Plugin AutoScaling.

Alerting interface for ETSI NFV-SOL 002/003 based Performance Management
========================================================================

.. rest_method::  POST /pm_event

Alert Tacker when one or more Performance values are obtained.

Response Codes
--------------

.. rest_status_code:: success status.yaml

  - 204

.. rest_status_code:: error status.yaml

  - 400
  - 404: prometheus_plugin_pm

Request Parameters
------------------

.. rest_parameters:: parameters_prometheus_plugin.yaml

  - alert: alert
  - \>status: status
  - \>labels: labels
  - \>\>receiver_type: receiver_type
  - \>\>function_type: function_type_pm
  - \>\>job_id: job_id
  - \>\>object_instance_id: object_instance_id
  - \>\>sub_object_instance_id: sub_object_instance_id
  - \>\>metric: metric
  - \>annotations: annotations
  - \>\>value: value
  - \>startsAt: startsAt
  - \>endsAt: endsAt
  - \>fingerprint: fingerprint

Request Example
---------------

.. literalinclude:: samples/prometheus_plugin/alert_pm.json
   :language: javascript


Alerting interface for ETSI NFV-SOL 002/003 based Fault Management
==================================================================

.. rest_method::  POST /alert

Alert Tacker when one or more Fault event are obtained.

Response Codes
--------------

.. rest_status_code:: success status.yaml

  - 204

.. rest_status_code:: error status.yaml

  - 400
  - 404: prometheus_plugin_fm

Request Parameters
------------------

.. rest_parameters:: parameters_prometheus_plugin.yaml

  - alert: alert
  - \>status: status
  - \>labels: labels
  - \>\>receiver_type: receiver_type
  - \>\>function_type: function_type_fm
  - \>\>vnf_instance_id: vnf_instance_id
  - \>\>pod: pod
  - \>\>perceived_severity: perceived_severity
  - \>\>event_type: event_type
  - \>annotations: annotations
  - \>\>probable_cause: probable_cause
  - \>\>fault_type: fault_type
  - \>\>fault_details: fault_details
  - \>startsAt: startsAt
  - \>endsAt: endsAt
  - \>fingerprint: fingerprint

Request Example
---------------

.. literalinclude:: samples/prometheus_plugin/alert_fm.json
   :language: javascript

Alerting interface for Prometheus Plugin AutoScaling
====================================================

.. rest_method::  POST /alert

Alert Tacker when scaling should be performed.

Response Codes
--------------

.. rest_status_code:: success status.yaml

  - 204

.. rest_status_code:: error status.yaml

  - 400
  - 404: prometheus_plugin_auto_scale

Request Parameters
------------------

.. rest_parameters:: parameters_prometheus_plugin.yaml

  - alert: alert
  - \>status: status
  - \>labels: labels
  - \>\>receiver_type: receiver_type
  - \>\>function_type: function_type_auto_scale
  - \>\>vnf_instance_id: vnf_instance_id
  - \>\>auto_scale_type: auto_scale_type
  - \>\>aspect_id: aspect_id
  - \>annotations: annotations
  - \>startsAt: startsAt
  - \>endsAt: endsAt
  - \>fingerprint: fingerprint

Request Example
---------------

.. literalinclude:: samples/prometheus_plugin/alert_auto_scale.json
   :language: javascript