如何从烧瓶端点返回纯文本？普罗米修斯需要

Question

我需要设置一个/metrics端点，以便 Prometheus 可以使用有关端点的统计信息。我该怎么做？

我的 Flask 应用程序中有这个：

@app.route('/metrics')
def metrics():
    def generateMetrics():
        metrics = ""
        ... some string builder logic
        return metrics

    response = make_response(generateMetrics(), 200)
    response.mimetype = "text/plain"
    return response

这是最好的方法吗？返回字符串（只返回metrics此处）和返回纯文本有什么区别？为什么我需要 mimetype？

Answer 1

这是最好的方法吗？

有几种方法可以设置 MIME 类型，在这个 StackOverflow 问题中更好地解释和讨论。你的方式工作正常并完成工作。

返回字符串和返回纯文本有什么区别？

如果你返回一个字符串 Flask 会自动为你处理一些 Response 逻辑。这意味着使用一些默认值。如果您设置了两个不同的端点，您将看到不同之处在于您的代码返回以下标头：

Content-Type:"text/plain; charset=utf-8"

虽然只返回一个字符串（和默认 MIME 类型）将返回以下标头：

Content-Type:"text/html; charset=utf-8"

为什么我需要 mimetype？

您可能会说它在技术上更正确，因为您的响应只是纯文本，而不是 HTML。但是，需要它的一个更有说服力的原因是您正在使用的第三方系统（Prometheus）依赖或关心“Content-Type”标头的内容。如果他们这样做，那么你必须设置它让他们接受它。

示例代码

对于 Content-Type 标头演示，我使用了以下示例 Python 代码：

from flask import Flask, make_response
app = Flask(__name__)


def generateMetrics():
    return "hello world"


@app.route('/metrics')
def metrics():
    response = make_response(generateMetrics(), 200)
    response.mimetype = "text/plain"
    return response


@app.route('/metrics2')
def metrics2():
    return generateMetrics()

然后我使用 Postman 查看返回的正文和标题。