跳转到主要内容

OpenStack Monasca Ceilometer - 为Monasca提供计量服务

项目描述

团队和仓库标签

https://governance.openstack.org/tc/badges/monasca-ceilometer.svg

monasca-ceilometer

Python插件和存储驱动程序,用于Ceilometer将样本发送到monasca-api。也称为Ceilosca

安装

自动设置Ceilosca的安装说明

devstack/README.md

手动设置Ceilosca的安装说明

要自动设置Ceilosca,请阅读devstack/README.md或使用包含的Vagrantfile

假设在安装DevStack后运行了活动的monasca-api服务器。

  1. 运行devstack以安装openstack,包括Monasca和Ceilometer插件。

  2. 安装python-monascaclient。

    pip install python-monascaclient
  3. 从github.com克隆monasca-ceilometer。

  4. 将以下文件从ceilosca/ceilometer复制到devstack的ceilometer位置,通常是/opt/stack/ceilometer

    monasca_client.py
    monasca_opts.py
    opts.py
    publisher/monasca_data_filter.py
    publisher/monasca.py
    tests/* (skipping the init.py files)
  5. 编辑 setup.cfg 文件(安装时使用)

    在“ceilometer.sample.publisher =”部分添加以下行

    monasca = ceilometer.publisher.monasca:MonascaPublisher
  6. 配置 /etc/ceilometer/pipeline.yaml 以将指标发送到 Monasca 发布者。使用包含的 monasca-ceilometer/etc/ceilometer/pipeline.yaml 文件作为示例。

  7. 配置 /etc/ceilometer/ceilometer.conf 以设置 Ceilometer 的存储驱动。使用包含的 monasca-ceilometer/etc/ceilometer/ceilometer.conf 文件作为示例。

  8. 将包含的 monasca_field_definitions.yml 文件从 monasca-ceilometer/etc/ceilometer 复制到 /etc/ceilometer

    monasca_field_definitions.yaml 文件包含如何根据每个计量器处理 Ceilometer 样本对象中每个字段的配置。该 monasca_data_filter.py 使用此文件,并且只存储在此配置文件中指定的字段。

  9. 确保在 ceilometer.conf 中的 [service_credentials] 下指定的用户已添加 monasca_user 角色。

其他安装信息

由于我们没有完整的 ceilometer 仓库,我们在 venv 中设置 ceilometer 仓库并复制 Monasca 集成文件,然后在该代码上运行单元测试。目前这已针对 ceilometer 稳定/pike 分支进行测试,如果您需要针对不同的分支进行测试,您可以在 test-requirements.txt 中更改它。

相关文件是

  • monasca_test_setup.py - 确定ceilometer venv路径并将相关文件复制过去

  • tox.ini - 调用设置和测试命令

  • test-requirements.txt - 包含测试所需的依赖

使用 Ceilosca

定义或更改现有计量器

有时,Ceilometer 会引入新的计量器。当前支持的测量列表可以在 https://docs.openstack.org/ceilometer/pike/admin/telemetry-measurements.html(由 https://github.com/openstack/ceilometer/doc/source/admin/telemetry-measurements.rst 生成)中找到。

某些计量器需要在 Ceilometer 中进行额外配置。例如,SDN 摄取器计量器需要专用驱动程序。有关 Ceilometer 如何通过轮询或收集收集计量器的更多信息,请参阅 遥测文档测量

定义哪些计量器从 Ceilometer 发布到 Monasca API

与 Ceilometer 一样,要发布的计量器列表在 /etc/ceilometer/pipeline.yaml 中指定。

随着时间推移,计量数据积累,建议 Ceilometer 仅发布客户需要数据的计量器。此外,建议检查 Monasca 代理捕获的测量值以避免数据重复。

要启用或禁用计量器,

  1. 识别当前收集的计量器列表,指定在 /etc/ceilometer/pipeline.yaml 中。提示:您可以通过 `monasca metric-list`(或 Pike 及更早版本中的 `ceilometer meter-list`)查看当前正在报告的计量器。

  2. 编辑 /etc/ceilometer/pipeline.yaml 文件以添加或删除计量器列表中的条目。

  3. 对所有控制平面节点重复更改。

  4. 重新启动所有 Ceilometer 通知代理、轮询代理和中心服务以获取更改。

要创建新的计量器(或清理已删除的计量器),

  1. 测量 页面上识别此 OpenStack Ceilometer 发布版中可用的计量器。

    • 识别应传输到 Monasca 的参数。

    • 识别计量器的来源。请注意,轮询计量器可能需要额外配置。

  2. 使用新计量器修改 monasca_field_definitions.yml

  3. 在所有控制节点上重新启动 Ceilometer 服务。

此外,请注意,HPE 发布了描述如何配置计量服务(在 Helion OpenStack 3.0 及更高版本中使用 Ceilosca)的文档,这可能有助于了解历史背景。链接 1 链接 2 链接 3

使用 Monasca API 通过 Ceilosca 收集的计量数据

以下是一些示例,说明如何找到并使用 Ceilometer 和 Ceilosca 采集的计量数据在 Monasca API 中的用法。

在 Ceilometer 管道 YAML 文件中

Ceilometer 计量器

Monasca API 指标

vcpus

vcpus

image.size

image.size

disk.root.size

disk.root.size

memory

memory

storage.objects

storage.objects

注意:Monasca 代理可以直接收集许多类似的指标,例如虚拟机的 CPU 时间。为了简化,建议优先使用 Monasca 代理选择要使用的指标。

许可

版权 (c) 2015-2017 惠普开发公司,L.P.

版权 (c) 2018 SUSE LLC

根据 Apache 许可证 2.0 版(“许可证”);除非适用法律要求或经书面同意,否则不得使用此文件,除非符合许可证。您可以在以下位置获得许可证副本:

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或经书面同意,否则在许可证下分发的软件按“原样”基础分发,不提供任何明示或暗示的保证或条件。有关许可证的具体语言,请参阅许可证。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。

源代码发行版

monasca_ceilometer-1.10.0.tar.gz (128.2 kB 查看散列)

上传时间 源代码

构建发行版

monasca_ceilometer-1.10.0-py2.py3-none-any.whl (30.2 kB 查看散列)

上传时间 Python 2 Python 3

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面