字段管理
索引模式中的字段会以列表的方式显示,点击列标题可以按列对表格排序,点击最右边列的 控制 按钮可以编辑指定字段的属性。您可以从 格式 下拉菜单中手动设置字段的格式。具体格式选项依赖于字段类型。
您也可以在 流行度 文本框中设置您需要的该字段的流行度值。点击 更新字段 按钮确认更改,或者点击 取消 返回字段列表。
Kibana 有以下字段类型的格式化:
字符串字段格式化
字符串字段支持 String
和 Url
的格式化。
字符串
字段格式化可以对字段内容做如下转换:
- 转换为小写
- 转换为大写
- 转化为标题 (单词的第一个字母大写)
- 应用短点转换,对于
.
字符之前的内容,它将用其第一个字符替换整个字符串。如下所示:原始字符串
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。
日期字段格式化
日期字段支持 Date
、 Url
和 String
格式化。
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
数字字段格式化
数字字段支持 Url
、 Bytes
、 Duration
、 Number
、 Percentage
、 String
和 Color
格式化
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 会显示 区间 、 字体颜色 、 背景颜色 和 范例 字段。
点击 添加颜色 按钮将一段区间值与一个特定颜色关联。您可以点击 字体颜色 和 背景颜色 字段来显示颜色选择器,也可以在该字段中输入十六进制的颜色码。最后您可以在 范例 字段中看到所选颜色的效果。
Bytes
、 Number
和 Percentage
格式化可以让您使用 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
创建一个脚本化字段
要创建脚本化字段:
- 进入 设置 > 索引
- 选择您要添加脚本化字段的索引模式。
- 进入模式的 脚本化字段 标签页。
- 点击 添加脚本化字段 。
- 输入脚本化字段的名称。
- 输入您想要通过索引数据即时计算值的表达式。
- 点击 保存脚本化字段 。
有关 Elasticsearch 中脚本化字段的更多信息,请参考 Scripting。
更新一个脚本化字段
要修改一个脚本化字段:
- 进入 设置 > 索引 。
- 点击您想要修改的脚本化字段的 编辑 按钮。
- 修改并点击 保存脚本化字段 以更新字段。
WARNING:请注意,脚本化字段没有内置验证。如果您的脚本有问题,每次当您尝试查看动态生成的数据时,都会遇到异常。
删除一个脚本化字段
要删除一个脚本化字段:
- 进入 设置 > 索引 。
- 点击要删除的脚本化字段的 删除 按钮。
- 确认您确实要删除该字段。