菜单
文档breadcrumb arrow 插件breadcrumb arrow Oracle 数据源breadcrumb arrow 配置 Oracle 数据源
Enterprise Grafana Cloud

配置 Oracle 数据源

Grafana 为 Oracle 数据源提供了多种配置选项。有关安装数据源的通用信息，请参阅安装 Grafana 插件。有关添加数据源的通用信息，请参阅添加数据源。

开始之前

您必须拥有 Organization Administrator 角色才能添加数据源。管理员还可以使用 Grafana 的配置系统通过 YAML 配置数据源。

为了添加 Oracle 数据源，您必须首先安装 Oracle 插件。有关安装说明，请参阅 Oracle 插件页面上的安装。

注意

添加数据源时，请确保您指定的数据库用户仅对您要查询的相关数据库和表具有 SELECT 权限。Grafana 不会验证查询的安全性，这意味着它们可能包含潜在有害的 SQL 语句，例如 DROP TABLE user; 或 DELETE FROM user;，这些语句可能会被执行。为了最大程度地降低此风险，Grafana 强烈建议创建一个具有受限权限的专用 Oracle 数据库用户。

配置数据源

要添加 Oracle 数据源，请完成以下步骤

  1. 安装 Oracle 插件。
  2. 单击左侧菜单中的连接（Connections）。
  3. 在连接（Connections）下，单击添加新连接（Add new connection）。
  4. 在搜索栏中输入 Oracle。
  5. 在数据源（Data Source）部分下选择 Oracle Database。
  6. 单击右上角的添加新数据源（Add new data source）。

您将被带到设置（Settings）选项卡，您可以在其中设置 Oracle 配置。

配置选项

以下是 Oracle 的配置选项列表。

  • 名称（Name） - 数据源名称。这是您在面板和查询中引用数据源的方式。示例：Oracle Database-1, Oracle-DB-Sales。
  • 默认（Default） - 切换此选项可将此 Oracle 数据源设置为面板和可视化中的默认预选数据源。

连接

您可以通过两种不同的连接方法连接到 Oracle，具体取决于您是本地部署还是云账户。

  • 带 TCP 端口的主机（Host with TCP Port） - 使用带 TCP 端口号的主机名或 IP 地址进行连接。

    • 主机（Host） - 输入带 TCP 端口号的主机名或 IP 地址。

    • 数据库（Database） - 输入数据库名称。

  • TNSNames 条目（TNSNames Entry） - 仅限 Enterprise 版。指定 tnsnames.ora 条目进行连接。Grafana Cloud 中不提供此功能。

    • TNSName - 使用 tnsnames.ora 文件中指定的配置连接。

身份验证

您可以在下拉列表中选择两种身份验证方法。身份验证方法取决于您的连接方法。

  • 基本身份验证（Basic authentication） - 这是带 TCP 端口主机连接方法唯一可用的身份验证方法。使用用户名和密码进行身份验证。

    • 用户（User） - 拥有指定数据库访问权限的 Oracle 用户名。

    • 密码（Password） - 拥有指定数据库访问权限的 Oracle 密码。

  • Kerberos 身份验证（Kerberos Authentication） - Grafana Cloud 中不支持。Kerberos 身份验证仅在使用 TNSNames 时有效，并且必须在 tnsnames.ora 配置文件中进行配置。有关配置参数，请参阅Kerberos 集成。请遵循 Oracle 文档配置 Kerberos 身份验证以将 Oracle 与 Kerberos 集成。

其他设置

  • 时区（Timezone） - 从下拉列表中选择 Oracle 服务器在 UTC 中的默认时区。

私有数据源连接 (PDC)

  • 私有数据源连接（Private data source connect）： - 仅适用于 Grafana Cloud 用户。私有数据源连接（PDC）允许您在 Grafana Cloud 实例（或堆栈）与私有网络内受保护的数据源之间建立私密、安全的连接。单击下拉列表以查找 PDC 的 URL。有关 PDC 工作原理的更多信息，请参阅私有数据源连接；有关设置 PDC 连接的步骤，请参阅配置 Grafana 私有数据源连接 (PDC)。

单击管理私有数据源连接（Manage private data source connect），即可前往您的 PDC 连接页面，您可以在其中找到您的 PDC 配置详细信息。

配置好 Oracle 数据源选项后，单击底部的保存并测试（Save & test）以测试您的数据源连接。您还可以通过单击删除（Delete）来移除连接。

通过配置（Provisioning）配置数据源

您可以将 Oracle 数据源定义和配置在 YAML 文件中，作为 Grafana 配置系统的一部分。有关配置数据源的更多信息以及可用的配置选项，请参阅配置 Grafana。

以下是 Oracle 数据源的配置示例。

TNSNames 已启用并使用基本身份验证

yaml 
apiVersion: 1
datasources:
  - name: Oracle (TNS-BASICAUTH)
    type: grafana-oracle-datasource
    access: proxy
    basicAuth: false
    editable: true
    jsonData:
      timezone_name: UTC
      useKerberosAuthentication: false
      useTNSNamesBasedConnection: true
      user: USERNAME
    secureJsonData:
      password: PASSWORD
    url: TNSNAME
    version: 1

TNSNames 已禁用并使用基本身份验证

yaml 
apiVersion: 1
datasources:
  - name: Oracle (Integration)
    type: grafana-oracle-datasource
    access: proxy
    basicAuth: false
    editable: true
    jsonData:
      database: DATABASE
      user: USERNAME
    secureJsonData:
      password: PASSWORD
    url: HOST
    version: 1

其他配置

您可以使用环境变量或更新 Grafana Server 配置文件来调整 Oracle 数据源连接详细信息。

注意

Grafana Cloud 中不支持环境变量。

最大响应大小

您可以在环境变量中设置 GF_PLUGINS_ORACLE_DATASOURCE_MAX_RESPONSE_SIZE 来更改查询响应数据大小。默认值为 16，最大值为 512。

export GF_PLUGINS_ORACLE_DATASOURCE_MAX_RESPONSE_SIZE=<number>

连接池大小

您可以在环境变量中设置 GF_PLUGINS_ORACLE_DATASOURCE_POOLSIZE 来更改连接池大小。默认值为 50

export GF_PLUGINS_ORACLE_DATASOURCE_POOLSIZE=<number>

或者，您可以在 Grafana 配置文件 grafana.ini 的 [plugins] 部分配置这些参数。

[plugins]
oracle_datasource_poolsize = 50
oracle_datasource_max_response_size = 16