Spec-Zone.ru › Graphite

API URL для рендеринга графиков

Веб-приложение graphite предоставляет конечную точку /render для генерации графиков и получения исходных данных. Эта конечная точка принимает различные аргументы через параметры запроса. Эти параметры разделяются амперсандом (&) и предоставляются в формате:

&name=value

Чтобы убедиться, что API работает и может генерировать изображения, откройте http://GRAPHITE_HOST:GRAPHITE_PORT/render в браузере. API должен вернуть простое изображение размером 330x250 с текстом «Нет данных».

После запуска API и начала загрузки данных в carbon, используйте параметры ниже для настройки графиков и извлечения исходных данных. Например:

# single server load on large graph
http://graphite/render?target=server.web1.load&height=800&width=600

# average load across web machines over last 12 hours
http://graphite/render?target=averageSeries(server.web*.load)&from=-12hours

# number of registered users over past day as raw json data
http://graphite/render?target=app.numUsers&format=json

# rate of new signups per minute
http://graphite/render?target=summarize(derivative(app.numUsers),"1min")&title=New_Users_Per_Minute

Примечание

Большинство функций и параметров чувствительны к регистру. Например, &linewidth=2 приведет к молчаливому отказу. Правильный параметр в этом случае &lineWidth=2

Графики метрик

Для начала построения графиков конкретных метрик, передайте один или несколько параметров target и укажите временной интервал для графика с помощью from/until.

target

Параметр target указывает путь, идентифицирующий одну или несколько метрик, с опциональными функциями, действующими на эти метрики. Пути документированы ниже, в то время как функции перечислены на странице Функций.

Пути и подстановочные знаки

Пути метрик показывают путь, разделенный точками, от корня дерева метрик (часто начинающегося с servers) до метрики, например servers.ix02ehssvc04v.cpu.total.user.

Пути также поддерживают следующие подстановочные знаки, что позволяет идентифицировать более одной метрики в одном пути.

Звёздочка

Звёздочка (*) соответствует нулю или более символам. Она не жадная, поэтому вы можете иметь более одной в одном элементе пути.

Пример: servers.ix*ehssvc*v.cpu.total.* вернёт все метрики общего использования ЦП для всех серверов, соответствующих заданному шаблону имени.

Список символов или диапазон

Символы в квадратных скобках ([...]) указывают одну позицию символа в строке пути и соответствуют ей, если символ в этой позиции соответствует одному из символов в списке или диапазоне.

Диапазон символов обозначается двумя символами, разделёнными дефисом (-), и означает, что любой символ между этими двумя символами (включительно) будет соответствовать. Можно включить несколько диапазонов в квадратные скобки, например, foo[a-z0-9]bar будет соответствовать foopbar, foo7bar и т. д..

Если символы не могут быть интерпретированы как диапазон, они обрабатываются как список — любой символ в списке будет соответствовать, например, foo[bc]ar будет соответствовать foobar и foocar. Если вы хотите включить дефис (-) в свой список, поместите его в начало или конец, чтобы он не интерпретировался как диапазон.

Список значений
Значения, разделённые запятыми в фигурных скобках ({foo,bar,...}), обрабатываются как списки значений, и соответствуют, если любое из значений совпадает с текущей точкой в пути. Например, servers.ix01ehssvc04v.cpu.total.{user,system,iowait} будет соответствовать метрикам общего использования ЦП для пользователя, системы и ожидания ввода-вывода для указанного сервера.

Примечание

Все подстановочные знаки применяются только внутри одного элемента пути. Другими словами, они не включают и не пересекают точки (.). Поэтому servers.* не будет соответствовать servers.ix02ehssvc04v.cpu.total.user, в то время как servers.*.*.*.* будет.

Метки рядов

При запросе меток рядов мы начинаем с функции seriesByTag:

# find all series that have tag1 set to value1
seriesByTag('tag1=value1')

См. запрос меток рядов для получения дополнительной информации об использовании seriesByTag.

Примеры

Это отобразит одну или несколько метрик

Пример:

&target=company.server05.applicationInstance04.requestsHandled
(draws one metric)

Предположим, что на каждом сервере работают 4 идентичных экземпляра приложения.

&target=company.server05.applicationInstance*.requestsHandled
(draws 4 metrics / lines)

Теперь предположим, что у вас есть 10 серверов.

&target=company.server*.applicationInstance*.requestsHandled
(draws 40 metrics / lines)

Вы также можете выполнить любое количество функций над различными метриками перед построением графиков.

&target=averageSeries(company.server*.applicationInstance.requestsHandled)
(draws 1 aggregate line)

Несколько вызовов функций могут быть объединены, либо вложенные, либо передав результат в другую функцию (он будет передан в функцию как первый параметр):

&target=movingAverage(aliasByNode(company.server*.applicationInstance.requestsHandled,1),"5min")
&target=aliasByNode(company.server*.applicationInstance.requestsHandled,1)|movingAverage("5min")
&target=company.server*.applicationInstance.requestsHandled|aliasByNode(1)|movingAverage("5min")
&target=movingAverage(company.server*.applicationInstance.requestsHandled|aliasByNode(1),"5min")
(these are all equivalent)

Параметр target также можно повторить, чтобы построить графики нескольких связанных метрик.

&target=company.server1.loadAvg&target=company.server1.memUsage

Примечание

Если отображается более 10 метрик, легенда больше не отображается. Подробности см. в параметре hideLegend.

from/until

Это необязательные параметры, которые указывают относительный или абсолютный временной период для построения графика. from указывает начало, until указывает конец. Если from опущено, оно по умолчанию равно 24 часам назад. Если until опущено, оно по умолчанию равно текущему времени (сейчас).

Существует несколько форматов для этих функций:

&from=-RELATIVE_TIME
&from=ABSOLUTE_TIME

RELATIVE_TIME — это отрезок времени с момента текущего времени. Он всегда предваряется знаком минус ( -) и сопровождается единицей времени. Допустимые единицы времени:

Сокращение Единица измерения
с Секунды
мин Минуты
ч Часы
д Дни
нед Недели
мес 30 дней (месяц)
год 365 дней (год)

ABSOLUTE_TIME имеет формат ЧЧ:ММ_ГГГГММДД, ГГГГММДД, ММ/ДД/ГГ или любой другой at(1)-совместимый формат времени.

Сокращение Значение
ЧЧ Часы в формате 24-часовых часов. Временные интервалы до 12 часов должны включать ведущие нули.
ММ Минуты
ГГГГ Год в 4-х цифрах.
ММ Числовой месяц с ведущим нулём
ДД День месяца с ведущим нулём

&from и &until могут смешивать абсолютное и относительное время по желанию.

Примеры:

&from=-8d&until=-7d
(shows same day last week)

&from=04:00_20110501&until=16:00_20110501
(shows 4AM-4PM on May 1st, 2011)

&from=20091201&until=20091231
(shows December 2009)

&from=noon+yesterday
(shows data since 12:00pm on the previous day)

&from=6pm+today
(shows data since 6:00pm on the same day)

&from=january+1
(shows data since the beginning of the current year)

&from=monday
(show data since the previous monday)

template

Метрики target могут использовать специальную функцию template, которая позволяет путям метрик содержать переменные. Значения для этих переменных могут быть предоставлены через параметр запроса template.

Примеры

Пример:

&target=template(hosts.$hostname.cpu)&template[hostname]=worker1

Значения по умолчанию для переменных шаблона также могут быть предоставлены:

&target=template(hosts.$hostname.cpu, hostname="worker1")

Вместо именованных можно использовать позиционные аргументы:

&target=template(hosts.$1.cpu, "worker1")
&target=template(hosts.$1.cpu, "worker1")&template[1]=worker*

Помимо подстановки путей, переменные можно использовать для числовых и строковых литералов:

&target=template(constantLine($number))&template[number]=123
&target=template(sinFunction($name))&template[name]=nameOfMySineWaveMetric

Форматы отображения данных

В дополнение к рендерингу изображения, API также может генерировать SVG с вложенными метаданными, PDF или возвращать исходные данные в различных форматах для внешнего построения графиков, анализа или мониторинга.

format

Управляет форматом возвращаемых данных. Влияет на все &targets параметры, переданные в URL.

Примеры:

&format=png
&format=raw
&format=csv
&format=json
&format=svg
&format=pdf
&format=dygraph
&format=rickshaw

png

Отображает график в виде PNG-изображения размера, определяемого width и height.

raw

Отображает данные в пользовательском формате, разделённом по строкам. Метки выводятся по одной строке и имеют формат <target name>,<start timestamp>,<end timestamp>,<series step>|[data]*

entries,1311836008,1311836013,1|1.0,2.0,3.0,5.0,6.0

csv

Отображает данные в формате CSV, подходящем для импорта в табличный процессор или для обработки в скрипте

entries,2011-07-28 01:53:28,1.0
entries,2011-07-28 01:53:29,2.0
entries,2011-07-28 01:53:30,3.0
entries,2011-07-28 01:53:31,5.0
entries,2011-07-28 01:53:32,6.0

json

Отображает данные в формате JSON. Опция jsonp может использоваться для обертывания этих данных в вызов с именем для доступа к данным через домены

[{
  "target": "entries",
  "datapoints": [
    [1.0, 1311836008],
    [2.0, 1311836009],
    [3.0, 1311836010],
    [5.0, 1311836011],
    [6.0, 1311836012]
  ]
}]

svg

Отображает график в формате SVG-разметки размером, определяемым width и height. Метаданные об отрисованном графике сохраняются как вложенный скрипт с переменной metadata, имеющей значение объекта, описывающего график

<script>
  <![CDATA[
    metadata = {
      "area": {
        "xmin": 39.195507812499997,
        "ymin": 33.96875,
        "ymax": 623.794921875,
        "xmax": 1122
      },
      "series": [
        {
          "start": 1335398400,
          "step": 1800,
          "end": 1335425400,
          "name": "summarize(test.data, \"30min\", \"sum\")",
          "color": "#859900",
          "data": [null, null, 1.0, null, 1.0, null, 1.0, null, 1.0, null, 1.0, null, null, null, null],
          "options": {},
          "valuesPerPoint": 1
        }
      ],
      "y": {
        "labelValues": [0, 0.25, 0.5, 0.75, 1.0],
        "top": 1.0,
        "labels": ["0 ", "0.25 ", "0.50 ", "0.75 ", "1.00  "],
        "step": 0.25,
        "bottom": 0
      },
      "x": {
        "start": 1335398400,
        "end": 1335423600
      },
      "font": {
        "bold": false,
        "name": "Sans",
        "italic": false,
        "size": 10
      },
      "options": {
        "lineWidth": 1.2
      }
    }
  ]]>
</script>

pdf

Отображает график в формате PDF размером, определяемым width и height.

dygraph

Отображает данные как JSON-объект, подходящий для передачи в объект Dygraph.

{
  "labels" : [
    "Time",
    "entries"
  ],
  "data" : [
    [1468791890000, 0.0],
    [1468791900000, 0.0]
  ]
}

rickshaw

Отображает данные как JSON-объект, подходящий для передачи в объект Rickshaw.

[{
  "target": "entries",
  "datapoints": [{
    "y": 0.0,
    "x": 1468791890
  }, {
    "y": 0.0,
    "x": 1468791900
  }]
}]

pickle

Возвращает Python pickle (сериализованный объект Python). Ответ будет иметь тип MIME ‘application/pickle’. Объект pickle представляет собой список словарей с ключами: name, start, end, step, и values как показано ниже:

[
  {
    'name' : 'summarize(test.data, "30min", "sum")',
    'start': 1335398400,
    'end'  : 1335425400,
    'step' : 1800,
    'values' : [None, None, 1.0, None, 1.0, None, 1.0, None, 1.0, None, 1.0, None, None, None, None],
  }
]

rawData

Устарело начиная с версии 0.9.9: Этот параметр устарел в пользу параметра format

Используется для получения числовых данных из веб-приложения вместо изображения. Может быть установлено в true, false, csv. Влияет на все &targets параметры, переданные в URL.

Пример:

&target=carbon.agents.graphiteServer01.cpuUsage&from=-5min&rawData=true

Возвращает следующий текст:

carbon.agents.graphiteServer01.cpuUsage,1306217160,1306217460,60|0.0,0.00666666520965,0.00666666624282,0.0,0.0133345399694

Параметры графика

areaAlpha

По умолчанию: 1.0

Принимает число с плавающей точкой от 0,0 до 1,0

Устанавливает значение альфа (прозрачности) залитых областей при использовании areaMode

areaMode

По умолчанию: none

Включает залив области под нарисованными линиями. Цвет залитой области совпадает с цветом линии. Смотрите areaAlpha для создания прозрачности этой области. Принимает одно из следующих значений, определяющее режим заливки:

none
Отключает режим areaMode
first
Заполняет область под первой целью и не под другими
all
Заполняет области под каждой целью
stacked
Создаёт график, где заполненная область каждой цели накладывается друг на друга. Каждая целевая линия отображается как сумма всех предыдущих линий плюс значение текущей линии.

bgcolor

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Устанавливает цвет фона графика.

Имена цветов Значение RGB
чёрный 0,0,0
белый 255,255,255
синий 100,100,255
зелёный 0,200,0
красный 200,0,50
жёлтый 255,255,0
оранжевый 255, 165, 0
фиолетовый 200,100,255
коричневый 150,100,50
аквамарин 0,150,150
серый 175,175,175
серый 175,175,175
пурпурный 255,0,255
розовый 255,100,100
золотой 200,200,0
розовый 200,150,200
тёмно-синий 0,0,255
тёмно-зелёный 0,255,0
тёмно-красный 255,0,0
тёмно-серый 111,111,111
тёмно-серый 111,111,111

RGB можно передать напрямую в формате #RRGGBB[AA], где RR, GG и BB — 2-значные шестнадцатеричные значения для красного, зелёного и синего соответственно. AA — необязательное дополнение, описывающее непрозрачность («альфа»). FF — полностью непрозрачно, 00 — полностью прозрачно.

Примеры:

&bgcolor=blue
&bgcolor=2222FF
&bgcolor=5522FF60

cacheTimeout

По умолчанию: значение DEFAULT_CACHE_DURATION из local_settings.py

Время в секундах для кеширования отрисованного графика (актуально только при настройке memcached)

colorList

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Принимает одно или несколько разделенных запятыми имён цветов или значений RGB (см. bgcolor для списка имён цветов) и использует этот список в порядке, как цвета линий. Если нарисовано больше линий/метрики, чем цветов, список переиспользуется в порядке. Любое значение RGB также может иметь необязательную прозрачность (00 — полностью прозрачно, FF — непрозрачно), как показано во втором примере.

Пример:

&colorList=green,yellow,orange,red,purple,DECAFF
&colorList=FF000055,00FF00AA,DECAFFEF

drawNullAsZero

По умолчанию: false

Преобразует все значения None (null) в отображаемых метриках в ноль во время отрисовки.

fgcolor

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Устанавливает цвет переднего плана. Это влияет только на заголовок, текст легенды и подписи осей.

См. majorGridLineColor и minorGridLineColor для более тонкого управления цветами.

См. bgcolor для списка имён цветов и подробностей по форматированию этого параметра.

fontBold

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Если установлено в true, шрифт становится жирным.

Пример:

&fontBold=true

fontItalic

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Если установлено в true, шрифт становится курсивным/наклонным. По умолчанию false.

Пример:

&fontItalic=true

fontName

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Изменяет шрифт, используемый для отображения текста на графике. Шрифт должен быть установлен на сервере Graphite.

Пример:

&fontName=FreeMono

fontSize

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Изменяет размер шрифта. Должен быть положительным числом с плавающей точкой или целым числом, равным или большим 1. По умолчанию 10

Пример:

&fontSize=8

format

См.: Форматы отображения данных

from

См.: from / until

graphOnly

По умолчанию: False

Отображает только область графика без линий сетки, осей или легенды

graphType

По умолчанию: line

Устанавливает тип графика для отображения. В настоящее время доступны только два типа графиков:

line
Линейный график, отображающий метрики как линии во времени
pie
Круговой график, где каждый сектор отображает агрегированное значение каждой метрики, рассчитанное с использованием функции, указанной в pieMode

hideLegend

По умолчанию: <unset>

Если установлено в true, легенда не рисуется. Если установлено в false, легенда рисуется. Если не задано, значение LEGEND_MAX_ITEMS в local_settings.py используется для определения отображения легенды.

Подсказка: если установлено false, параметр &height может потребоваться увеличить, чтобы вместить дополнительный текст.

Пример:

&hideLegend=false

hideNullFromLegend

По умолчанию: False

Если установлено в true, серии со всеми нулевыми значениями не будут отображаться в легенде.

Пример:

&hideNullFromLegend=true

hideAxes

По умолчанию: False

Если установлено в true, оси X и Y не будут отображаться

Пример:

&hideAxes=true

hideXAxis

По умолчанию: False

Если установлено в true, ось X не будет отображаться

hideYAxis

По умолчанию: False

Если установлено в true, ось Y не будет отображаться

hideGrid

По умолчанию: False

Если установлено в true, линии сетки не будут отображаться

Пример:

&hideGrid=true

height

По умолчанию: 250

Устанавливает высоту генерируемого изображения графика в пикселях.

См. также: width

Пример:

&width=650&height=250

jsonp

По умолчанию: <unset>

Если установлено и используется совместно с format=json, оборачивает ответ JSON вызовом функции, имя которой указано в параметре.

leftColor

По умолчанию: цвет, выбранный из colorList

В режиме двух осей Y устанавливает цвет всех метрик, связанных с левой осью Y.

leftDashed

По умолчанию: False

В режиме двух осей Y рисует все метрики, связанные с левой осью Y, пунктирными линиями

leftWidth

По умолчанию: значение параметра lineWidth

В режиме двух осей Y устанавливает ширину линий всех метрик, связанных с левой осью Y

lineMode

По умолчанию: slope

Устанавливает поведение рисования линий. Принимает один из следующих параметров:

slope
Режим линии наклона рисует линию от каждой точки к следующей. Периоды с нулевыми значениями не будут нарисованы
staircase
Лестничный режим рисует прямую линию на протяжении периода времени, а затем вертикальную линию вверх или вниз до следующего значения
connected
Подобно линии наклона, но значения всегда соединяются линией наклона, независимо от того, есть ли нулевые значения между ними

Пример:

&lineMode=staircase

lineWidth

По умолчанию: 1.2

Принимает любые значения с плавающей точкой или целые числа (отрицательные числа не вызывают ошибки, но не приведут к отображению линии). Изменяет ширину линии в пикселях.

Пример:

&lineWidth=2

logBase

По умолчанию: <unset>

Если установлено, отображает график с логарифмической шкалой указанного основания (например, 10 для десятичного логарифма)

localOnly

По умолчанию: False

Установите для предотвращения получения данных с удалённых серверов Graphite, возвращая только метрики, доступные локально

majorGridLineColor

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Устанавливает цвет основных линий сетки.

См. bgcolor для допустимых имён цветов и форматов.

Пример:

&majorGridLineColor=FF22FF

margin

По умолчанию: 10 Устанавливает отступ вокруг изображения графика в пикселях со всех сторон.

Пример:

&margin=20

max

Устаревшее с версии 0.9.0: См. yMax

maxDataPoints

Устанавливает максимальное количество точек данных для каждой серии, возвращаемой при использовании json-контента.

Если для любой выходной серии количество точек данных в выбранном диапазоне превышает значение maxDataPoints, то точки данных за весь период консолидируются.

Функция, используемая для консолидации точек, может быть задана с помощью функции consolidateBy.

minorGridLineColor

По умолчанию: значение из шаблона [default] в graphTemplates.conf

Устанавливает цвет линий вспомогательной сетки.

См. bgcolor для допустимых имён цветов и форматов.

Пример:

&minorGridLineColor=darkgrey

minorY

Устанавливает количество линий вспомогательной сетки на одну основную линию на оси Y.

Пример:

&minorY=3

min

Устаревшее с версии 0.9.0: См. yMin

minXStep

По умолчанию: 1

Устанавливает минимальный шаг в пикселях между точками данных, используемый для рисования. Любое значение ниже этого вызовет консолидацию точек серии во время отрисовки. Значение по умолчанию 1 в сочетании с шириной линии по умолчанию 1.2 приведет к минимальному перекрытию линий между близлежащими точками. Чтобы отключить консолидацию точек во время отрисовки, установите это значение в 0, хотя имейте в виду, что серии с большим количеством точек, чем пикселей на области графика (например, данные за несколько месяцев с данными за каждую минуту), будут выглядеть очень «сжатыми», так как будет много перекрытия линий. В ответ можно использовать lineWidth для компенсации этого.

noCache

По умолчанию: False

Установите, чтобы отключить кеширование отрисованных изображений

noNullPoints

По умолчанию: False

Если установлено и используется совместно с format=json, удаляет все нулевые данные из возвращенного ряда.

pickle

Устарело начиная с версии 0.9.10: См. Форматы отображения данных

pieLabels

По умолчанию: horizontal

Ориентация меток сегментов внутри круговой диаграммы.

horizontal
Метки ориентированы горизонтально в каждом сегменте
rotated
Метки ориентированы радиально в каждом сегменте

pieMode

По умолчанию: average

Тип агрегации для расчета сегментов круговой диаграммы, когда graphType=pie. Один из:

average
Среднее значение ненулевых точек в ряду
maximum
Максимальное значение ненулевых точек в ряду
minimum
Минимальное значение ненулевых точек в ряду

pretty

По умолчанию: <unset>

Если установлено в 1 и используется совместно с format=json, выводит JSON в удобном для чтения формате.

rightColor

По умолчанию: цвет, выбранный из colorList

В режиме двойной оси Y задает цвет всех метрик, связанных с правой осью Y.

rightDashed

По умолчанию: False

В режиме двойной оси Y рисует все метрики, связанные с правой осью Y, пунктирной линией.

rightWidth

По умолчанию: значение параметра lineWidth

В режиме двойной оси Y задает толщину линии всех метрик, связанных с правой осью Y.

template

По умолчанию: default

Используется для задания шаблона из graphTemplates.conf для использования по умолчанию цветов и стилей графиков.

Пример:

&template=plain

thickness

Устарело начиная с версии 0.9.0: См.: lineWidth

title

По умолчанию: <unset>

Добавляет заголовок вверху графика, центрированный. Если не установлено, заголовок не отображается.

Пример:

&title=Apache Busy Threads, All Servers, Past 24h

tz

По умолчанию: часовой пояс, указанный в local_settings.py

Часовой пояс для преобразования всех времен.

Примеры:

&tz=America/Los_Angeles
&tz=UTC

Примечание

Чтобы изменить часовой пояс по умолчанию, отредактируйте webapp/graphite/local_settings.py.

uniqueLegend

По умолчанию: False

Отображает только уникальные элементы легенды, удаляя дубликаты.

until

См.: from / until

valueLabels

По умолчанию: percent

Определяет, как отображаются метки сегментов на круговой диаграмме.

none
Метки сегментов не отображаются
numbers
Метки сегментов отображаются с исходными значениями
percent
Метки сегментов отображаются как процент от целого

valueLabelsColor

По умолчанию: черный

Цвет используемый для отображения меток сегментов на круговой диаграмме.

valueLabelsMin

По умолчанию: 5

Значения сегментов ниже этого минимума не будут отображаться в метках.

vtitle

По умолчанию: <unset>

Подписывает ось y вертикальным текстом. Если не установлено, метка оси y не отображается.

Пример:

&vtitle=Threads

vtitleRight

По умолчанию: <unset>

В режиме двойной оси Y задаёт заголовок правой оси Y (См.: vtitle)

width

По умолчанию: 330

Задает ширину сгенерированного изображения графика в пикселях.

См. также: height

Пример:

&width=650&height=250

xFilesFactor

По умолчанию: DEFAULT_XFILES_FACTOR, указанный в local_settings.py, или 0

Устанавливает значение по умолчанию xFilesFactor используемое при агрегации во время выполнения по нескольким рядам и/или интервалам.

См. функцию xFilesFactor для получения дополнительной информации о значении xFilesFactor и о том, как можно переопределить значение по умолчанию для определённых целей или рядов.

xFormat

По умолчанию: Определяется автоматически в зависимости от ширины оси X по времени

Задает формат времени, используемый при отображении оси X. См. datetime.date.strftime() для получения подробностей о спецификации формата.

yAxisSide

По умолчанию: left

Устанавливает сторону графика, на которой отображается ось Y. Принимает значения left или right

yDivisors

По умолчанию: 4,5,6

Задает предпочтительное количество промежуточных значений для отображения на оси Y (значения Y между минимальным и максимальным). Обратите внимание, что Graphite в конечном итоге выберет, какие значения (и сколько) отобразить, на основе фактора «pretty», который пытается поддерживать разумную шкалу (например, предпочитая промежуточные значения, такие как 25%, 50%, 75%, а не 33,3%, 66,6%). Чтобы явно задать значения оси Y, см. yStep

yLimit

Зарезервировано для будущего использования. См.: yMax

yLimitLeft

Зарезервировано для будущего использования. См.: yMaxLeft

yLimitRight

Зарезервировано для будущего использования. См.: yMaxRight

yMin

По умолчанию: наименьшее значение любого из отображаемых рядов

Вручную задаёт нижнюю границу графика. Можно передавать целые или дробные числа.

Пример:

&yMin=0

yMax

По умолчанию: наибольшее значение любого из отображаемых рядов

Вручную задаёт верхнюю границу графика. Можно передавать целые или дробные числа.

Пример:

&yMax=0.2345

yMaxLeft

В режиме двойной оси Y задаёт верхнюю границу левой оси Y (См.: yMax)

yMaxRight

В режиме двойной оси Y задаёт верхнюю границу правой оси Y (См.: yMax)

yMinLeft

В режиме двойной оси Y задаёт нижнюю границу левой оси Y (См.: yMin)

yMinRight

В режиме двойной оси Y задаёт нижнюю границу правой оси Y (См.: yMin)

yStep

По умолчанию: вычисляется автоматически

Вручную задаёт шаг значения между метками и линиями сетки оси Y.

yStepLeft

В режиме двойной оси Y вручную задаёт шаг значения между метками и линиями сетки левой оси Y (См.: yStep)

yStepRight

В режиме двойной оси Y вручную задаёт шаг значения между метками и линиями сетки правой оси Y (См.: yStep)

yUnitSystem

По умолчанию: si

Устанавливает систему единиц для сжатия значений оси Y (например, 23 000 000 становится 23М). Значение может быть одним из:

si
Использование единиц системы СИ (степени 1000) - К, М, Г, Т, П
binary
Использование двоичных единиц (степени 1024) - Ки, Ми, Ги, Ти, Пи
sec
Использование единиц времени (секунды) - м, Ч, Д, М, Г
msec
Использование единиц времени (миллисекунды) - с, м, Ч, Д, М, Г
none
Не сжимать значения, отображать исходное число

© 2008–2012 Chris Davis
© 2011–2016 The Graphite Project
Licensed under the Apache License, Version 2.0.
https://graphite.readthedocs.io/en/latest/render_api.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API