当前位置: 首页 > 文档资料 > Kibana 中文文档 >

字段管理

优质
小牛编辑
133浏览
2023-12-01

索引模式中的字段会以列表的方式显示,点击列标题可以按列对表格排序,点击最右边列的 控制 按钮可以编辑指定字段的属性。您可以从 格式 下拉菜单中手动设置字段的格式。具体格式选项依赖于字段类型。

您也可以在 流行度 文本框中设置您需要的该字段的流行度值。点击 更新字段 按钮确认更改,或者点击 取消 返回字段列表。

Kibana 有以下字段类型的格式化:

字符串字段格式化

字符串字段支持 StringUrl 的格式化。

字符串 字段格式化可以对字段内容做如下转换:

  • 转换为小写
  • 转换为大写
  • 转化为标题 (单词的第一个字母大写)
  • 应用短点转换,对于 . 字符之前的内容,它将用其第一个字符替换整个字符串。如下所示:

    原始字符串

    com.organizations.project.ClassName

    转换后

    c.o.p.ClassName

Url 字段格式化支持如下类型:

  • 链接 类型可以将字段的内容转化为一个 URL 。
  • 图片 类型可以用于指定一张特定图片所在的图片目录。

您可以用模板来自定义任意类型的 URL 字段格式。一个 URL 模板 可以让您添加特定的值作为 URL 的一部分。使用字符串 {{value}} 可以将其值添加到指定的 URL。

例如,当:

  • 一个字段含有一个用户 ID
  • 对该字段使用了 Url 字段格式化
  • URI 模板为 http://company.net/profiles?user_id={­{value}­}

生成的 URL 会用来自该字段的用户 ID 替换 {{value}}

{{value}} 模板字符串会对字段内容做 URL 编码。当一个字段编码为 URL 出现非 ASCII 字符时,这些字符会被替换为由 % 字符加上相对应的十六进制代码。例如,字段值 users/admin 编码到 URL 模板中会变为 users%2Fadmin

当格式化的类型为 图片 时, {{value}} 模板字符串会被替换为对应 URI 图片的名称。

如果想要将未转义的值直接传递给URL,需要使用 {{rawValue}} 字符串。

标签模板 可以让您显示一段文本而不是直接显示 URL,您可以在标签模板中使用普通的模板字符串 {{value}} 。也可以使用 {{url}} 模板字符串来显示格式化的 URL。

日期字段格式化

日期字段支持 DateUrlString 格式化。

Date 格式化能让您使用 moment.js 标准格式定义来选择日期的显示格式。

字符串 字段格式化可以对字段内容做如下转换:

  • 转换为小写
  • 转换为大写
  • 转化为标题 (单词的第一个字母大写)
  • 应用短点转换,对于 . 字符之前的内容,它将用其第一个字符替换整个字符串。如下所示:

    原始字符串 com.organizations.project.ClassName

    转换后

    c.o.p.ClassName

Url 字段格式化支持如下类型:

  • 链接 类型可以将字段的内容转化为一个 URL 。
  • 图片 类型可以用于指定一张特定图片所在的图片目录。

您可以用模板来自定义任意类型的 URL 字段格式。一个 URL 模板 可以让您添加特定的值作为 URL 的一部分。使用字符串 {{value}} 可以将其值添加到指定的 URL。

例如,当:

  • 一个字段含有一个用户 ID
  • 对该字段使用了 Url 字段格式化
  • URI 模板为 http://company.net/profiles?user_id={­{value}­}

生成的 URL 会用来自该字段的用户 ID 替换 {{value}}

{{value}} 模板字符串会对字段内容做 URL 编码。当一个字段编码为 URL 出现非 ASCII 字符时,这些字符会被替换为由 % 字符加上相对应的十六进制代码。例如,字段值 users/admin 编码到 URL 模板中会变为 users%2Fadmin

当格式化的类型为 图片 时, {{value}} 模板字符串会被替换为对应 URI 图片的名称。

如果想要将未转义的值直接传递给URL,需要使用 {{rawValue}} 字符串。

标签模板 可以让您显示一段文本而不是直接显示 URL,您可以在标签模板中使用普通的模板字符串 {{value}} 。也可以使用 {{url}} 模板字符串来显示格式化的 URL。

地理坐标字段格式化

地理坐标字段支持 String 格式化。

字符串 字段格式化可以对字段内容做如下转换:

  • 转换为小写
  • 转换为大写
  • 转化为标题 (单词的第一个字母大写)
  • 应用短点转换,对于 . 字符之前的内容,它将用其第一个字符替换整个字符串。如下所示:

    原始字符串 com.organizations.project.ClassName

    转换后

    c.o.p.ClassName

数字字段格式化

数字字段支持 UrlBytesDurationNumberPercentageStringColor 格式化

Url 字段格式化支持如下类型:

  • 链接 类型可以将字段的内容转化为一个 URL 。
  • 图片 类型可以用于指定一张特定图片所在的图片目录。

您可以用模板来自定义任意类型的 URL 字段格式。一个 URL 模板 可以让您添加特定的值作为 URL 的一部分。使用字符串 {{value}} 可以将其值添加到指定的 URL。

例如,当:

  • 一个字段含有一个用户 ID
  • 对该字段使用了 Url 字段格式化
  • URI 模板为 http://company.net/profiles?user_id={­{value}­}

生成的 URL 会用来自该字段的用户 ID 替换 {{value}}

{{value}} 模板字符串会对字段内容做 URL 编码。当一个字段编码为 URL 出现非 ASCII 字符时,这些字符会被替换为由 % 字符加上相对应的十六进制代码。例如,字段值 users/admin 编码到 URL 模板中会变为 users%2Fadmin

当格式化的类型为 图片 时, {{value}} 模板字符串会被替换为对应 URI 图片的名称。

如果想要将未转义的值直接传递给URL,需要使用 {{rawValue}} 字符串。

标签模板 可以让您显示一段文本而不是直接显示 URL,您可以在标签模板中使用普通的模板字符串 {{value}} 。也可以使用 {{url}} 模板字符串来显示格式化的 URL。

字符串 字段格式化可以对字段内容做如下转换:

  • 转换为小写
  • 转换为大写
  • 转化为标题 (单词的第一个字母大写)
  • 应用短点转换,对于 . 字符之前的内容,它将用其第一个字符替换整个字符串。如下所示:

    原始字符串 com.organizations.project.ClassName

    转换后 c.o.p.ClassName

持续时间 字段格式化可以以如下增量显示字段的数值:

  • Picoseconds 皮秒
  • Nanoseconds 纳秒
  • Microseconds 微秒
  • Milliseconds 毫秒
  • Seconds 秒
  • Minutes 分钟
  • Hours 小时
  • Days 天
  • Weeks 星期
  • Months 月
  • Years 年

对于输入和输出,您都可以指定最多20位数字的增量。

颜色 字段格式化可以让您为数值型字段的某一段值区间指定特定颜色。

当您选择 颜色 字段格式化时,Kibana 会显示 区间字体颜色背景颜色范例 字段。

点击 添加颜色 按钮将一段区间值与一个特定颜色关联。您可以点击 字体颜色背景颜色 字段来显示颜色选择器,也可以在该字段中输入十六进制的颜色码。最后您可以在 范例 字段中看到所选颜色的效果。

images/colorformatter.png

BytesNumberPercentage 格式化可以让您使用 numeral.js 标准格式定义来选择此字段中数字的显示格式。

脚本化字段

脚本化字段是依据 Elasticsearch 索引中的数据即时计算得到的。其作为文档数据的一部分显示在 发现 标签页上,您可以将其可视化,但是因为脚本化字段的值是在查询时实时计算产生的,所以它们不能被索引和查询。

NOTE:Kibana 不能查询脚本化字段

WARNING:脚本化字段因为实时计算数据,所以有可能非常耗费资源,并对 Kibana 的性能产生直接的影响。请记住,脚本化字段是没有内置校验的。如果脚本有问题,每当您试图去查看动态生成的数据时都会得到异常。

当您在 Kibana 中定义一个脚本化字段时,您可以选择使用的脚本语言。从 5.0 版本开始,默认的选项是 Lucene 表达式Painless。如果您在 Elasticsearch 中启用了其它动态脚本语言,也可以在 Kibana 中使用,但是不建议这样做。因为它们不能确保沙箱安全

WARNING:从 Elasticsearch 5.0 开始,不推荐使用 Groovy、 Javascript 和 Python 脚本,未来的版本中将不再支持这些脚本语言。

您可以在表达式中引用任何单值的数值字段,例如:

doc['field_name'].value

有关脚本化字段和其他范例的更多背景信息,请参阅此博客: Using Painless in Kibana scripted fields

创建一个脚本化字段

要创建脚本化字段:

  1. 进入 设置 > 索引
  2. 选择您要添加脚本化字段的索引模式。
  3. 进入模式的 脚本化字段 标签页。
  4. 点击 添加脚本化字段
  5. 输入脚本化字段的名称。
  6. 输入您想要通过索引数据即时计算值的表达式。
  7. 点击 保存脚本化字段

有关 Elasticsearch 中脚本化字段的更多信息,请参考 Scripting

更新一个脚本化字段

要修改一个脚本化字段:

  1. 进入 设置 > 索引
  2. 点击您想要修改的脚本化字段的 编辑 按钮。
  3. 修改并点击 保存脚本化字段 以更新字段。

WARNING:请注意,脚本化字段没有内置验证。如果您的脚本有问题,每次当您尝试查看动态生成的数据时,都会遇到异常。

删除一个脚本化字段

要删除一个脚本化字段:

  1. 进入 设置 > 索引
  2. 点击要删除的脚本化字段的 删除 按钮。
  3. 确认您确实要删除该字段。