Oracle Cloud Infrastructure Logging 数据源

介绍

Grafana 是一种流行的技术，可以轻松可视化日志和指标。OCI Logging Grafana 插件可用于扩展 Grafana，将 Oracle Cloud Infrastructure Logging 添加为 Grafana 中的数据源。

该插件允许您检索 Oracle Cloud 上多种资源的日志：计算、网络、存储、来自您应用的自定义日志以及 Oracle Cloud 服务生成的审计日志。将这些日志导入 Grafana 后，可以与指标一同分析，为您提供应用监控的单一视图。

最新插件版本 4.X.X（可在 Grafana Marketplace 获取）与 Grafana 10 兼容。

破坏性变更！如果您正在从 OCI Logging Grafana 插件的早期版本（2.x.x 或更低版本）迁移，并且未使用实例主体（身份验证提供程序未设置为 OCI 实例），请参阅 Grafana OCI Logging 数据源设置迁移说明（仅限用户主体和单租户模式），因为您将需要重新配置插件设置。

对于来自您应用的自定义日志，请参阅 OCI 上的自定义日志记录。

先决条件

我们将讨论 Grafana 需要就绪的两种不同的 Grafana IAM 配置，以便 Grafana 从 Oracle Cloud Logging 服务获取日志。

对于本地/开发环境和 Grafana Cloud

安装

请参阅以下 兼容性矩阵，根据您的 Grafana 安装选择相应的插件版本：兼容性矩阵

为了简化安装过程，我们为您创建了详细的指南。

根据您的安装场景，您可以使用以下指南

• 使用 本文档 在 Linux 主机上安装 Grafana 和 OCI Logs 插件。

• 使用 本文档 在 Grafana Cloud 上安装 Grafana 和 OCI Logs 插件。

• 使用 本文档 在 MacOS 主机上安装 Grafana 和 OCI Logs 插件。

配置 OCI 身份策略

在 OCI 控制台的 身份 > 组 下，点击 创建组 并创建一个名为 GrafanaLoggingUserGroup 的新组。将 OCI CLI 中配置的用户添加到新创建的组中。

在 策略 选项卡下，切换到根区间并点击 创建策略。创建一个策略，允许该组读取租户日志组和日志内容。添加以下策略语句

• allow group GrafanaLoggingUserGroup to read log-groups in tenancy
• allow group GrafanaLoggingUserGroup to read log-content in tenancy
• allow group GrafanaLoggingUserGroup to read compartments in tenancy

对于 Oracle Cloud Infrastructure 上的计算实例/虚拟机

为您的实例创建动态组

在 OCI 中预置一个 Oracle Linux 虚拟机，该虚拟机连接到一个可访问公共互联网的 虚拟云网络。如果您尚未拥有可访问公共互联网的虚拟云网络，您可以导航到 网络 选项下的 虚拟云网络 并点击 创建虚拟云网络。选择 创建虚拟云网络及相关资源 选项将创建一个带有互联网路由网关和路由表的 VCN，该 VCN 已配置为可访问公共互联网。将创建三个子网：每个区域可用性域中一个。

创建虚拟机后，下一步是创建一个 动态组，用于将虚拟机或裸金属计算实例分组为“主体”（类似于用户组）。

您可以按如下所示定义动态组，其中您的实例属于动态组定义中给定的区间。

为您实例的动态组创建 IAM 策略

接下来，在您的租户的根区间中创建一个名为“grafana_policy”的 策略，以允许动态组中的实例对 Oracle Cloud Infrastructure 服务进行 API 调用。添加以下策略语句

• allow dynamicgroup DynamicGroupForGrafanaInstances to read log-groups in tenancy
• allow dynamicgroup DynamicGroupForGrafanaInstances to read log-content in tenancy
• allow dynamicgroup DynamicGroupForGrafanaInstances to read compartments in tenancy

安装

根据您的安装场景，您可以使用以下指南

• 使用 本文档 在 Oracle Cloud Infrastructure 的虚拟机上安装 Grafana 和 OCI Logs 插件。

• 使用 Terraform 并参照 本文档 在 Oracle Cloud Infrastructure 的虚拟机上安装 Grafana 和 OCI Logs 插件。

• 使用 本文档 在 Oracle Cloud Infrastructure 的 Kubernetes 上安装 Grafana 和 OCI Logs 插件

注 1

OCI Logs 插件支持与 Grafana Cloud 集成，并将数据源 身份验证提供程序 配置为 local。请参阅 本文档 了解更多信息。

文档

请参阅 此 GitHub 仓库中的 docs 文件夹，了解有关安装和使用 OCI Logging 数据源的更多信息。

帮助

关于此插件的问题和疑问可以 作为 Issue 发布在此 GitHub 仓库中。

贡献

本项目欢迎社区贡献。在提交拉取请求之前，请 查看我们的贡献指南

安全性

请查阅 安全指南，了解我们的负责任安全漏洞披露流程。

许可证

Copyright (c) 2023 Oracle 和/或其关联公司。

根据 Universal Permissive License v1.0 发布，详情请参阅 https://oss.oracle.com/licenses/upl/。