> ## Documentation Index > Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > Параметры конфигурации плагина источника данных ClickHouse для Grafana # Настройка источника данных ClickHouse в Grafana export const ClickHouseSupportedBadge = () => { return

Поддерживается в ClickHouse

; }; export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return

; }; Проще всего изменить конфигурацию в интерфейсе Grafana на странице конфигурации плагина, но источники данных также можно [настроить с помощью YAML-файла](https://grafana.com/docs/grafana/latest/administration/provisioning/#data-sources). На этой странице приведён список параметров, доступных для настройки в плагине ClickHouse, а также фрагменты конфигурации для тех, кто настраивает источник данных с помощью YAML. Краткий обзор всех параметров и полный список опций конфигурации можно найти [здесь](#all-yaml-options).

## Общие настройки

Экран с примером конфигурации: Пример безопасной конфигурации для native-протокола

Пример YAML-конфигурации для общих настроек: ```yaml theme={null} jsonData: host: 127.0.0.1 # (required) server address. port: 9000 # (required) server port. For native, defaults to 9440 secure and 9000 insecure. For HTTP, defaults to 8443 secure and 8123 insecure. protocol: native # (required) the protocol used for the connection. Can be set to "native" or "http". secure: false # set to true if the connection is secure. username: default # the username used for authentication. tlsSkipVerify: # skips TLS verification when set to true. tlsAuth: # set to true to enable TLS client authentication. tlsAuthWithCACert: # set to true if CA certificate is provided. Required for verifying self-signed TLS certificates. secureJsonData: password: secureExamplePassword # the password used for authentication. tlsCACert: # TLS CA certificate tlsClientCert: # TLS client certificate tlsClientKey: # TLS client key ``` Обратите внимание, что при сохранении конфигурации из интерфейса добавляется свойство `version`. Оно показывает версию плагина, с которой была сохранена конфигурация.

### HTTP-протокол

Если выбрать подключение по HTTP-протоколу, отобразятся дополнительные настройки. Дополнительные параметры конфигурации HTTP

#### HTTP-путь

Если ваш HTTP-сервер доступен по другому URL-пути, укажите его здесь. ```yaml theme={null} jsonData: # без первого слэша path: additional/path/example ```

#### Пользовательские HTTP-заголовки

Вы можете добавлять пользовательские заголовки в запросы, отправляемые на сервер. Заголовки могут быть либо обычным текстом, либо защищёнными. Все имена заголовков хранятся в открытом виде, а защищённые значения заголовков сохраняются в защищённой конфигурации (аналогично полю `password`). **Защищённые значения по HTTP** Хотя защищённые значения заголовков безопасно хранятся в конфигурации, само значение всё равно будет передаваться по HTTP, если защищённое соединение отключено. Пример YAML для обычных и защищённых заголовков: ```yaml theme={null} jsonData: httpHeaders: - name: X-Example-Plain-Header value: plain text value secure: false - name: X-Example-Secure-Header # "value" исключено secure: true secureJsonData: secureHttpHeaders.X-Example-Secure-Header: secure header value ```

## Дополнительные настройки

Эти настройки необязательны. Пример дополнительных настроек

Пример YAML: ```yaml theme={null} jsonData: defaultDatabase: default # default database loaded by the query builder. Defaults to "default". defaultTable: # default table loaded by the query builder. dialTimeout: 10 # dial timeout when connecting to the server, in seconds. Defaults to "10". queryTimeout: 60 # query timeout when running a query, in seconds. Defaults to 60. This requires permissions on the user, if you get a permission error try setting it to "0" to disable it. validateSql: false # when set to true, will validate the SQL in the SQL editor. ```

### OpenTelemetry

OpenTelemetry (OTel) тесно интегрирован в плагин. Данные OpenTelemetry можно экспортировать в ClickHouse с помощью нашего [плагина-экспортёра](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/clickhouseexporter). Для оптимальной работы рекомендуется настроить OTel и для [журналов](#logs), и для [трассировок](#traces). Также необходимо настроить эти значения по умолчанию, чтобы включить [ссылки на данные](/docs/ru/integrations/connectors/data-visualization/grafana/query-builder#data-links) — функцию, которая обеспечивает мощные сценарии обсервабилити.

### Журналы

Чтобы ускорить [построение запросов к журналам](/docs/ru/integrations/connectors/data-visualization/grafana/query-builder#logs), можно задать базу данных и таблицу по умолчанию, а также столбцы для запроса к журналам. Это позволит заранее загрузить в конструктор запросов готовый к выполнению запрос к журналам, что ускорит просмотр на странице Explore в сценариях обсервабилити. Если вы используете OpenTelemetry, включите переключатель "**Use OTel**" и задайте **таблицу журналов по умолчанию** — `otel_logs`. Это автоматически заменит столбцы по умолчанию в соответствии с выбранной версией схемы OTel. Хотя OpenTelemetry не обязателен для журналов, использование единого набора данных для журналов и трассировки помогает выстроить более удобный процесс обсервабилити с [связыванием данных](/docs/ru/integrations/connectors/data-visualization/grafana/query-builder#data-links). Пример экрана конфигурации журналов: Конфигурация журналов

Пример YAML-конфигурации журналов: ```yaml theme={null} jsonData: logs: defaultDatabase: default # default log database. defaultTable: otel_logs # default log table. If you're using OTel, this should be set to "otel_logs". otelEnabled: false # set to true if OTel is enabled. otelVersion: latest # the otel collector schema version to be used. Versions are displayed in the UI, but "latest" will use latest available version in the plugin. # Default columns to be selected when opening a new log query. Will be ignored if OTel is enabled. timeColumn: # the primary time column for the log. levelColumn: # the log level/severity of the log. Values typically look like "INFO", "error", or "Debug". messageColumn: # the log's message/content. ```

### Трассировка

Чтобы ускорить [построение запросов для трассировки](/docs/ru/integrations/connectors/data-visualization/grafana/query-builder#traces), можно задать базу данных и таблицу по умолчанию, а также столбцы для запроса трассировки. Это позволит заранее загрузить в конструктор запросов готовый к выполнению поисковый запрос по трассировке, что ускорит просмотр данных на странице Explore для задач обсервабилити. Если вы используете OpenTelemetry, следует включить переключатель "**Use OTel**" и задать **таблицу трассировки по умолчанию** `otel_traces`. Это автоматически заменит столбцы по умолчанию в соответствии с выбранной версией схемы OTel. Хотя OpenTelemetry не обязателен, эта возможность лучше всего работает при использовании его схемы для трассировки. Пример экрана конфигурации трассировки: Конфигурация трассировки

Пример YAML-конфигурации трассировки: ```yaml theme={null} jsonData: traces: defaultDatabase: default # default trace database. defaultTable: otel_traces # default trace table. If you're using OTel, this should be set to "otel_traces". otelEnabled: false # set to true if OTel is enabled. otelVersion: latest # the otel collector schema version to be used. Versions are displayed in the UI, but "latest" will use latest available version in the plugin. # Default columns to be selected when opening a new trace query. Will be ignored if OTel is enabled. traceIdColumn: # trace ID column. spanIdColumn: # span ID column. operationNameColumn: # operation name column. parentSpanIdColumn: # parent span ID column. serviceNameColumn: # service name column. durationTimeColumn: # duration time column. durationUnitColumn: # duration time unit. Can be set to "seconds", "milliseconds", "microseconds", or "nanoseconds". For OTel the default is "nanoseconds". startTimeColumn: # start time column. This is the primary time column for the trace span. tagsColumn: # tags column. This is expected to be a map type. serviceTagsColumn: # service tags column. This is expected to be a map type. ```

### Псевдонимы столбцов

Псевдонимы столбцов — это удобный способ выполнять запросы к данным, используя другие имена и типы. С их помощью можно преобразовать вложенную схему в плоскую, чтобы в Grafana было проще выбирать нужные поля. Псевдонимы могут быть полезны, если: * Вы знаете свою схему и большинство её вложенных свойств/типов * Вы храните данные в типе Map * Вы храните JSON в виде строк * Вы часто применяете функции для преобразования выбираемых столбцов

#### ALIAS-столбцы, заданные в таблице

ClickHouse изначально поддерживает псевдонимы столбцов и сразу работает с Grafana. ALIAS-столбцы можно задавать прямо в таблице. ```sql theme={null} CREATE TABLE alias_example ( TimestampNanos DateTime(9), TimestampDate ALIAS toDate(TimestampNanos) ) ``` В приведённом выше примере мы создаём псевдоним `TimestampDate`, который преобразует временную метку с точностью до наносекунд в тип `Date`. Эти данные, в отличие от первого столбца, не хранятся на диске, а вычисляются во время выполнения запроса. Псевдонимы, определённые на уровне таблицы, не возвращаются при `SELECT *`, но это можно настроить в настройках сервера. Подробнее см. в документации по типу столбца [ALIAS](/docs/ru/reference/statements/create/table#alias).

#### Таблицы псевдонимов столбцов

По умолчанию Grafana предлагает столбцы на основе ответа на `DESC table`. В некоторых случаях может потребоваться полностью переопределить столбцы, которые видит Grafana. Это помогает скрыть схему в Grafana при выборе столбцов, что, в зависимости от сложности таблицы, может улучшить пользовательский опыт. Преимущество этого подхода перед псевдонимами, заданными в самой таблице, в том, что их можно легко обновлять без изменения таблицы. В некоторых схемах это может насчитывать тысячи записей, что может загромождать определение исходной таблицы. Кроме того, это позволяет скрыть столбцы, которые пользователь должен игнорировать. Grafana требует, чтобы таблица псевдонимов имела следующую структуру столбцов: ```sql theme={null} CREATE TABLE aliases ( `alias` String, -- The name of the alias, as seen in the Grafana column selector `select` String, -- The SELECT syntax to use in the SQL generator `type` String -- The type of the resulting column, so the plugin can modify the UI options to match the data type. ) ``` Вот как можно воспроизвести поведение столбца `ALIAS` с помощью таблицы псевдонимов: ```sql theme={null} CREATE TABLE example_table ( TimestampNanos DateTime(9) ); CREATE TABLE example_table_aliases (`alias` String, `select` String, `type` String); INSERT INTO example_table_aliases (`alias`, `select`, `type`) VALUES ('TimestampNanos', 'TimestampNanos', 'DateTime(9)'), -- Preserve original column from table (optional) ('TimestampDate', 'toDate(TimestampNanos)', 'Date'); -- Add new column that converts TimestampNanos to a Date ``` Затем эту таблицу можно настроить для использования в Grafana. Обратите внимание, что имя может быть любым и даже может быть задано в отдельной базе данных: Пример конфигурации таблицы псевдонимов

Теперь Grafana будет видеть результаты таблицы псевдонимов вместо результатов `DESC example_table`: Пример выборки из таблицы псевдонимов

Оба типа использования псевдонимов можно применять для сложных преобразований типов или извлечения полей JSON.

## Все параметры YAML

Ниже приведены все параметры конфигурации YAML, доступные в этом плагине. Для некоторых полей указаны примеры значений, а для других — только тип поля. Дополнительные сведения о настройке источников данных с помощью YAML см. в [документации Grafana](https://grafana.com/docs/grafana/latest/administration/provisioning/#data-sources). ```yaml theme={null} datasources: - name: Example ClickHouse uid: clickhouse-example type: grafana-clickhouse-datasource jsonData: host: 127.0.0.1 port: 9000 protocol: native secure: false username: default tlsSkipVerify: tlsAuth: tlsAuthWithCACert: defaultDatabase: default defaultTable: dialTimeout: 10 queryTimeout: 60 validateSql: false httpHeaders: - name: X-Example-Plain-Header value: plain text value secure: false - name: X-Example-Secure-Header secure: true logs: defaultDatabase: default defaultTable: otel_logs otelEnabled: false otelVersion: latest timeColumn: levelColumn: messageColumn: traces: defaultDatabase: default defaultTable: otel_traces otelEnabled: false otelVersion: latest traceIdColumn: spanIdColumn: operationNameColumn: parentSpanIdColumn: serviceNameColumn: durationTimeColumn: durationUnitColumn: startTimeColumn: tagsColumn: serviceTagsColumn: secureJsonData: tlsCACert: tlsClientCert: tlsClientKey: secureHttpHeaders.X-Example-Secure-Header: secure header value ```