From d416724fd9710c6b7cc6c1d40b4763aca08333cf Mon Sep 17 00:00:00 2001 From: yolossn Date: Sun, 16 May 2021 12:18:40 +0530 Subject: [PATCH 1/4] Document metrics and update overview section Signed-off-by: yolossn --- content/docs/introduction/overview.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/content/docs/introduction/overview.md b/content/docs/introduction/overview.md index 870414ba7..1c31e7c8f 100644 --- a/content/docs/introduction/overview.md +++ b/content/docs/introduction/overview.md @@ -17,6 +17,8 @@ the project's governance structure, Prometheus joined the [Cloud Native Computing Foundation](https://cncf.io/) in 2016 as the second hosted project, after [Kubernetes](http://kubernetes.io/). +Prometheus collects and stores its metrics as time series data, i.e. metrics information is stored with the timestamp at which it was recorded, alongside optional key-value pairs called labels. + For more elaborate overviews of Prometheus, see the resources linked from the [media](/docs/introduction/media/) section. @@ -33,6 +35,14 @@ Prometheus's main features are: * targets are discovered via service discovery or static configuration * multiple modes of graphing and dashboarding support +### What are metrics ? + +In layperson terms, metrics are a standard for measurement. What we want to measure differs from application to application. For a web server it can be request times, for a database it can be number of active connections or number of active queries etc. + +Metrics play an important role in understanding why your application is working in a certain way. Lets assume you are running a web application and find that the application is slow. You will need some information to find out what is happening with your application. For example the application can become slow when the number of requests are high. If you have the request count metric you can spot the reason and increase the number of servers to handle the heavy load. + +Whenever you are defining the metrics for your application you must put on your detective hat and ask this question what all information will be important for me to debug if any issue occurs in my application? + ### Components The Prometheus ecosystem consists of multiple components, many of which are From f5f3006a7ec920b629f1c4dbed296c0f2f47bc2b Mon Sep 17 00:00:00 2001 From: S Santhosh Nagaraj Date: Tue, 27 Jul 2021 14:19:26 +0530 Subject: [PATCH 2/4] Update content/docs/introduction/overview.md Co-authored-by: Richard Hartmann --- content/docs/introduction/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/introduction/overview.md b/content/docs/introduction/overview.md index 1c31e7c8f..54f13a465 100644 --- a/content/docs/introduction/overview.md +++ b/content/docs/introduction/overview.md @@ -37,7 +37,7 @@ Prometheus's main features are: ### What are metrics ? -In layperson terms, metrics are a standard for measurement. What we want to measure differs from application to application. For a web server it can be request times, for a database it can be number of active connections or number of active queries etc. +In layperson terms, metrics are numeric measurements, time series mean that changes are recorded over time. What users want to measure differs from application to application. For a web server it might be request times, for a database it might be number of active connections or number of active queries etc. Metrics play an important role in understanding why your application is working in a certain way. Lets assume you are running a web application and find that the application is slow. You will need some information to find out what is happening with your application. For example the application can become slow when the number of requests are high. If you have the request count metric you can spot the reason and increase the number of servers to handle the heavy load. From c788046235ea0aefdee9ecdef1c5ddc3c62ec0dd Mon Sep 17 00:00:00 2001 From: S Santhosh Nagaraj Date: Tue, 27 Jul 2021 14:19:36 +0530 Subject: [PATCH 3/4] Update content/docs/introduction/overview.md Co-authored-by: Richard Hartmann --- content/docs/introduction/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/introduction/overview.md b/content/docs/introduction/overview.md index 54f13a465..e0b047a15 100644 --- a/content/docs/introduction/overview.md +++ b/content/docs/introduction/overview.md @@ -39,7 +39,7 @@ Prometheus's main features are: In layperson terms, metrics are numeric measurements, time series mean that changes are recorded over time. What users want to measure differs from application to application. For a web server it might be request times, for a database it might be number of active connections or number of active queries etc. -Metrics play an important role in understanding why your application is working in a certain way. Lets assume you are running a web application and find that the application is slow. You will need some information to find out what is happening with your application. For example the application can become slow when the number of requests are high. If you have the request count metric you can spot the reason and increase the number of servers to handle the heavy load. +Metrics play an important role in understanding why your application is working in a certain way. Lets assume you are running a web application and find that the application is slow. You will need some information to find out what is happening with your application. For example the application can become slow when the number of requests are high. If you have the request count metric you can spot the reason and increase the number of servers to handle the load. Whenever you are defining the metrics for your application you must put on your detective hat and ask this question what all information will be important for me to debug if any issue occurs in my application? From 5d4d6150cd5e1be363bac626d2c96d9c3321a05c Mon Sep 17 00:00:00 2001 From: S Santhosh Nagaraj Date: Tue, 27 Jul 2021 14:20:37 +0530 Subject: [PATCH 4/4] Update content/docs/introduction/overview.md Co-authored-by: Richard Hartmann --- content/docs/introduction/overview.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/content/docs/introduction/overview.md b/content/docs/introduction/overview.md index e0b047a15..532f1233a 100644 --- a/content/docs/introduction/overview.md +++ b/content/docs/introduction/overview.md @@ -40,9 +40,6 @@ Prometheus's main features are: In layperson terms, metrics are numeric measurements, time series mean that changes are recorded over time. What users want to measure differs from application to application. For a web server it might be request times, for a database it might be number of active connections or number of active queries etc. Metrics play an important role in understanding why your application is working in a certain way. Lets assume you are running a web application and find that the application is slow. You will need some information to find out what is happening with your application. For example the application can become slow when the number of requests are high. If you have the request count metric you can spot the reason and increase the number of servers to handle the load. - -Whenever you are defining the metrics for your application you must put on your detective hat and ask this question what all information will be important for me to debug if any issue occurs in my application? - ### Components The Prometheus ecosystem consists of multiple components, many of which are