普罗米修斯去客户端库
在这个页面:
介绍
下面的快速入门提供设置指令和普罗米修斯的预配置的仪表板客户端库。贯穿在这个快速入门的步骤之后,您将:
设置和配置的客户端库收集普罗米修斯指标如总保留内存,堆栈内存使用和堆内存。去客户端库会公开这些Prometheus-style指标。
普罗米修斯刮去客户端库配置指标和可选船Grafana云。
进口Grafana仪表板可视化你的度量数据。
指标使用
这个出口国出版大约45普罗米修斯默认时间序列。看到一个度量列表默认发货出口国,请下载样本指标刮伤在这里。
注意,取决于它的配置,普罗米修斯去客户端库可能收集和发布指标远远超过这个默认设置。了解更多关于配置普罗米修斯去客户端库及其收藏家切换,请参见普罗米修斯去客户端库GitHub库。
超出了普罗米修斯去切换客户端库的设置,可以通过放弃减少指标使用时间序列不需要存储在普罗米修斯或Grafana云。学习如何做到这一点,请参阅减少普罗米修斯指标和重新使用从Grafana云文档。
Grafana云Golang一体化
如果你使用Grafana云,您可以跳过本指南的所有步骤中通过安装普罗米修斯去整合,其目的是帮助你获得启动并运行命令和点击。免费注册。
学习如何设置普罗米修斯去客户端库与普罗米修斯集成,请参阅去集成从Grafana云文档。
在这个页面:
普罗米修斯去客户端库快速入门
在本指南您将了解如何设置和配置普罗米修斯去客户端库收集指标总保留内存和堆栈内存使用和公开Prometheus-style指标。您将配置普罗米修斯刮去度量和可选船Grafana云。最后,您将设置一个预配置Grafana指示板。本指南的末尾,你就会拥有一个仪表板,您可以使用可视化你的指标。
如果您正在使用Grafana云,去集成可以帮助你迅速启动并运行。集成嵌入一个普罗米修斯度量收集器中Grafana云代理并自动规定一个仪表板,所以你不需要贯穿本指南中的步骤。学习如何设置集成,请参阅去集成从Grafana云文档。
先决条件
在你开始之前,你应该有以下可用:
- 安装在你的机器上。要了解更多,请参阅下载并安装从文档。
- 普罗米修斯在您的环境中或直接在机器上运行。学习如何安装普罗米修斯,请参阅安装从普罗米修斯文档。
- Grafana运行在您的环境中或直接在机器上。学习如何安装Grafana,请参阅安装Grafana从Grafana文档。
- (可选)Grafana云账户。Grafana云主机Grafana和皮质端点的普罗米修斯指标。你仍然需要刮指标,使用普罗米修斯在您的环境中安装,或Grafana云代理。了解更多关于Grafana云,请参阅Grafana云。
步骤1:设置普罗米修斯去客户端库
在此步骤中,我们将设置客户端库去收集和暴露在普罗米修斯指标格式。本指南使用Ubuntu 20.04系统1.16.2去。步骤可能稍有不同,这取决于您的操作系统版本。
本指南将设置一个最小的应用程序暴露默认度量。仪器现有应用程序,请参阅client_golangGitHub库。
首先创建一个目录给你最小的去应用metrics_test,cd成:
mkdir metrics_test cd metrics_test接下来,初始化一个模块使用去国防部init:
去国防部init test_metrics:创造新的。国防部:模块test_metrics:添加模块需求和资金:去国防部整洁下载并安装任何必要的client_golang库的使用去:
去github.com/prometheus/client_golang/prometheus/promhttp去:添加github.com/prometheus/client_golang v1.9.0接下来,打开一个文件main.go使用您喜欢的编辑器,并粘贴在下面代码:
包主要进口("net/http "github.com/prometheus/client_golang/prometheus/promhttp)函数主要(){http。处理(“/指标”,promhttp.Handler ()) http。ListenAndServe (“2112”, nil)}这段代码设置一个最小/指标HTTP端点公开了一组默认的指标。它侦听HTTP请求localhost: 2112。
当你完成后,保存并关闭该文件。
编译和测试使用的代码去运行:
去运行main.go在这一点上您的shell应该挂。打开另一个会话或背景旋度指标端点的过程:
curl http://localhost: 2112 /指标。process_start_time_seconds 1.61559003439 e + 09年#帮助process_virtual_memory_bytes虚拟内存大小的字节。#式process_virtual_memory_bytes计process_virtual_memory_bytes 1.106751488 e + 09年#帮助process_virtual_memory_max_bytes最大虚拟内存中可用的字节。#式process_virtual_memory_max_bytes计process_virtual_memory_max_bytes 1 #帮助promhttp_metric_handler_requests_in_flight当前的窘境。#式promhttp_metric_handler_requests_in_flight计promhttp_metric_handler_requests_in_flight 1 #帮助promhttp_metric_handler_requests_total总数擦伤的HTTP状态代码。#类型promhttp_metric_handler_requests_total计数器promhttp_metric_handler_requests_total代码= " 200 "}{0 promhttp_metric_handler_requests_total代码= " 500 "}{0 promhttp_metric_handler_requests_total代码= " 503 "}{0如果你看到上面的输出中,您已经准备好开始使用普罗米修斯刮去度量。
使用client_golang,你也可以仪器现有应用程序发出自定义指标。更多地了解这些特性,请参阅去客户端库GitHub库。
第二步:刮普罗米修斯用普罗米修斯去客户端库
现在,普罗米修斯去客户端库启动并运行在您的机器上,您可以配置一个普罗米修斯刮工作收集并存储普罗米修斯去客户端库指标。
添加以下刮工作配置scrape_configs你的节prometheus.yml配置文件:
——job_name: static_configs:目标:[' localhost: 2112 ']取代本地主机与机器的IP地址运行您的应用程序。去了解更多关于配置普罗米修斯,请参阅配置从普罗米修斯文档。
如果你没有一个prometheus.yml配置文件,创建一个简单的一个使用您喜欢的文本编辑器。打开你喜欢的文本编辑器和粘贴在下面普罗米修斯配置:
全球:scrape_interval: 15秒scrape_configs: job_name: static_configs: -目标:(' localhost: 2112)这个配置告诉普罗米修斯刮所有工作每15秒。唯一刮配置工作去和定义了一个localhost: 2112目标。默认情况下,普罗米修斯将刮/指标使用HTTP端点。
保存并关闭该文件。然后您可以使用下面的命令运行普罗米修斯的文件:
/ prometheus.yml /普罗米修斯——config.file =航运指标Grafana云
船去度量Grafana云从普罗米修斯,配置remote_write参数在你prometheus.yml配置文件。要了解更多,请参阅度量——普罗米修斯从Grafana云文档。学习更多有关remote_write参数,请参阅remote_write从普罗米修斯文档。
步骤3:配置仪表板
本快速入门包括一个仪表板:
- 去运行时度量
学习如何导入该仪表板Grafana,请参阅导入一个仪表板从Grafana文档。
你可以卖到仪表板在这里。
结论
在这个快速入门你安装和运行一个最小的Linux机器上的应用程序,使普罗米修斯指标使用client_golang。然后配置普罗米修斯刮去度量暴露client_golang。最后,你进口Grafana仪表板想象去度量。
如果你使用Grafana云,你可以跳过所有的步骤在本指南通过安装集成Grafana云代理。学习如何设置集成,请参阅Grafana云集成。
仪表板使用生成普罗米修斯Mixin。mixin dasboards可重用模板,记录规则和警报策划和设计的主题专家。要了解更多,请参阅去混合存储库。
在这个页面:
Grafana云有一组不断扩大的集成快速得到一个可观测性堆栈在几分钟内启动并运行。的集成,内置Grafana云代理、擦伤基本指标和推动他们去Grafana云。公开的代理将刮指标client_golang图书馆,Grafana云会自动提供一个定制Grafana仪表板和作用于这个数据的可视化。
要了解更多,请查看Grafana云文档。
它是如何工作的
配置、安装、连接和维护普罗米修斯监控组件通常涉及重大的领域知识。可能需要很长一段时间从安装到仪表板和警报。Grafana的创造者——普罗米修斯和核心贡献者和皮层——我们构建简单的集成文摘的一些工作为了迅速开始。它是如何工作的:
- 注册(或登录)免费Grafana云账户。
- 选择目标你想观察(一个不断扩大的目录)。
- 运行一行命令安装Grafana代理。代理嵌入和preconfigures出口商公开默认度量,并逼迫他们Grafana云指标后端。
- 瞧!你会看到定制Grafana仪表盘和将受益于理智提醒违约。
寻找不同的出口商或集成?看看我们越来越多的图书馆为受欢迎的组件集成像MySQL、Postgres复述,Memcached和更多。