Writing Kibana 4 Plugins – Field Formatters
在阅读本教程之前，您需要阅读第1部分 - 基础知识。
在本教程的前面部分，我们主要关注如何编写自定义可视化类型。除了自定义可视化功能，Kibana还有一些扩展点。其中一个扩展点是字段格式化程序。可以为特定索引模式设置中的任何字段选择字段格式化程序。然后在显示此字段的值时使用它，并且可以以其他方式转换或显示它，然后是普通数据。
有一些字段格式化程序构建在Kibana上（例如，将数字字段解释为颜色）。本部分教程系列介绍了如何编写自己的字段格式化程序。我们将创建一个Trend字段格式化程序。它将在一个数字或百分比字段值后面显示向上或向下箭头，取决于数字是正还是负。然后，该格式化器可用于内容代表任何形式趋势的字段。
Github地址：https://github.com/timroes/tr-k4p-fieldformatters
Registering a new field formatter
注册新的字段格式化器类似于注册新的可视化类型（如第2部分所示）。您只需在插件的index.js文件中的uiExports中添加一个新数组：
// Rest of file stripped (see GitHub for full file)
uiExports: {
fieldFormats: [‘plugins/tr-k4p-fieldformatters/trend‘]
}
这将在您的插件公共文件夹中的trend.js文件注册到字段格式。
注意bug：在所有当前的Kibana版本中（从Kibana 4.4.1开始），fieldFormats数组不正确使用。作为此Kibana版本的解决方法，请将您的字段格式添加到visTypes数组。它将工作，因为trend.js文件无论如何需要注册到适当的注册表，所以它在index.js中出现的数组无关紧要。有关此问题的进展，请参阅GitHub上的＃6040。
Creating your field formatter
为了创建trend字段格式化器，我们现在将在我们插件的公共目录中创建trend.js文件（如本系列前面部分的可视化）。该文件的内容将如下所示：
function TrendProvider(Private) {
var _ = require(‘lodash‘);
var FieldFormat = Private(require(‘ui/index_patterns/_field_format/FieldFormat‘));
_.class(Trend).inherits(FieldFormat);
function Trend(params) {
Trend.Super.call(this, params);
}
Trend.id = ‘tr-trend‘;
Trend.title = ‘Trend‘;
Trend.fieldType = [
‘number‘,
‘percentage‘
];
Trend.prototype._convert = function(value) {
// TO BE DONE
};
return Trend;
}
require(‘ui/registry/field_formats‘).register(TrendProvider);
该文件将包含一个简单的提供程序函数，它将创建格式化程序类。在我们的例子中，我们将它命名为TrendProvider。此功能将在最后一行注册到字段格式注册表。
在提供程序功能中，我们必须遵循以下步骤：
从ui / index_patterns / _field_format / FieldFormat继承FieldFormat类，它通过使用lodash在前几行完成。
之后，我们必须设置新的Trend类的一些属性，这将配置我们的字段格式：
id是该字段格式的唯一标识符，该格式应尽可能唯一，因为Kibana使用它来引用该字段格式。使用前缀的id（与您的个人/公司的ID）不会有任何伤害。
字段格式的title是当用户想要在Kibana的设置页面中选择适当的字段格式时显示给用户的字符串。
fieldType数组包含所有字段类型，对于该格式化程序，即在Kibana设置中编辑适当字段时将显示的所有类型。此数组中的有效类型为：number，boolean，date，ip，attachment，geo_point，geo_shape，string，murmur3（Murmur3插件散列），未知（未知字段类型）。
实际的转换是在你的类的_convert函数中完成的，我们稍后会来。
最后但并非最不重要的是，您的提供者必须返回刚刚创建的字段格式类。
Formatting values
实际的格式化逻辑是在您的格式化程序的_convert方法中完成的。该函数将该字段的值作为第一个参数。你只需要从函数返回任何你想要表示的字段。对于我们的trend格式化程序，可以使用以下函数：
Trend.prototype._convert = function(value) {
return (value > 0) ? value + ‘ ↑‘ : value + ‘ ↓‘;
};
为了方便起见，我们不会在这里检查0值，只需在值后面添加一个向上或向下箭头，取决于它是正还是负。
如果您的插件现在被正确加载，您可以转到Kibana中的任何索引设置，编辑一个数字或百分比字段，则你可以在格式化程序的选择框中看到您的trend格式化程序。如果将其用于字段，则箭头将附加到该字段值显示的位置。
无论函数返回什么都将被渲染为纯文本，即不允许HTML。但是可能有几种情况，您要将HTML代替纯文本作为格式化程序（例如，图像格式化程序，使用输出中的颜色等）要使用HTML渲染，您可以使用一个对象而不是一个函数，它们有两个键：html和text：
Trend.prototype._convert = {
text: function(value) {
// Return a textual representation of the value
},
html: function(value) {
// The return value of this function can contain HTML, which will be rendered.
}
};
如果你如上所示直接指定函数为_convert ，则文本功能完全一样。html函数的返回值可以包含将被呈现的HTML标记。
只要Kibana能够在需要显示值的地方（例如，Discover选项，可视化等等）几乎到处都可以使用HTML函数，并且文本功能将在某些HTML不适合的地方使用（例如，在仪表板上应用过滤器过滤值时，过滤条中显示的值将呈现为纯文本）。
对于HTML函数，Kibana还将该字段本身作为函数的第二个参数。这可以用来检索关于正在格式化实际字段的一些信息，例如field.type以获取其实际类型（例如，如果您支持多个字段类型）。但请注意，在Kibana无法成功确定字段类型的情况下，该值（完整字段值）可能为null或undefined ，例如当显示聚合结果的值时。第二个参数不适用于文本方法。
完整的例子，看看GitHub上的trend.js文件。
What‘s next?
字段格式化器可以更复杂，例如，携带自身的设置让用户自定义格式化。如果要创建一个更复杂的字段格式化程序，我建议您查看Kibana中现有的格式化程序。其中几个包含更多复杂的设置实现（例如Color或Date格式化程序）。
如果您有任何问题可以随意发表评论，请与我联系，或使用官方的Elasticsearch论坛。
原文地址：https://www.timroes.de/2016/02/17/writing-kibana-4-plugins-field-formatters/