diff --git a/.circleci/config.yml b/.circleci/config.yml index a8eb274f7..87b1ae683 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -23,7 +23,7 @@ jobs: command: ./deploy/ci-install-s3deploy.sh - run: name: Install NodeJS dependencies - command: sudo yarn global add postcss-cli autoprefixer redoc-cli + command: sudo yarn global add postcss-cli autoprefixer@9.8.6 redoc-cli - run: name: Generate API documentation command: cd api-docs && bash generate-api-docs.sh diff --git a/assets/styles/normalize/_import-now.scss b/assets/styles/normalize/_import-now.scss deleted file mode 100755 index edbdfff05..000000000 --- a/assets/styles/normalize/_import-now.scss +++ /dev/null @@ -1,11 +0,0 @@ -// Import Now -// -// If you import this module directly, it will immediately output all the CSS -// needed to normalize default HTML elements across all browsers. -// -// ``` -// @import "normalize/import-now"; -// ``` - -@import 'normalize'; -@include normalize(); diff --git a/assets/styles/normalize/_normalize-mixin.scss b/assets/styles/normalize/_normalize-mixin.scss deleted file mode 100755 index a366f7b9e..000000000 --- a/assets/styles/normalize/_normalize-mixin.scss +++ /dev/null @@ -1,666 +0,0 @@ -// Helper function for the normalize() mixin. -@function _normalize-include($section, $exclude: null) { - // Initialize the global variables needed by this function. - @if not global_variable_exists(_normalize-include) { - $_normalize-include: () !global; - $_normalize-exclude: () !global; - } - // Since we are given 2 parameters, set the global variables. - @if $exclude != null { - $include: $section; - // Sass doesn't have static variables, so the work-around is to stuff these - // values into global variables so we can access them in future calls. - $_normalize-include: if(type-of($include) == 'list', $include, ($include)) !global; - $_normalize-exclude: if(type-of($exclude) == 'list', $exclude, ($exclude)) !global; - @return true; - } - - // Check if $section is in the $include list. - @if index($_normalize-include, $section) { - @return true; - } - // If $include is set to (all), make sure $section is not in $exclude. - @else if not index($_normalize-exclude, $section) and index($_normalize-include, all) { - @return true; - } - @return false; -} - -@mixin normalize($include: (all), $exclude: ()) { - // Initialize the helper function by passing it this mixin's parameters. - $init: _normalize-include($include, $exclude); - - // If we've customized any font variables, we'll need extra properties. - @if $base-line-height != 24px - or $base-unit != 'em' - or $h2-font-size != 1.5 * $base-font-size - or $h3-font-size != 1.17 * $base-font-size - or $h4-font-size != 1 * $base-font-size - or $h5-font-size != 0.83 * $base-font-size - or $h6-font-size != 0.67 * $base-font-size { - $normalize-vertical-rhythm: true !global; - } - - /*! normalize-scss | MIT/GPLv2 License | bit.ly/normalize-scss */ - - @if _normalize-include(document) { - /* Document - ========================================================================== */ - - /** - * 1. Correct the line height in all browsers. - * 2. Prevent adjustments of font size after orientation changes in - * IE on Windows Phone and in iOS. - */ - - html { - @if $base-font-family { - /* Change the default font family in all browsers (opinionated). */ - font-family: $base-font-family; - } - @if $base-font-size != 16px or $normalize-vertical-rhythm { - // Correct old browser bug that prevented accessible resizing of text - // when root font-size is set with px or em. - font-size: ($base-font-size / 16px) * 100%; - } - @if $normalize-vertical-rhythm { - line-height: ($base-line-height / $base-font-size) * 1em; /* 1 */ - } - @else { - line-height: 1.15; /* 1 */ - } - -ms-text-size-adjust: 100%; /* 2 */ - -webkit-text-size-adjust: 100%; /* 2 */ - } - } - - @if _normalize-include(sections) { - /* Sections - ========================================================================== */ - - /** - * Remove the margin in all browsers (opinionated). - */ - - body { - margin: 0; - } - - /** - * Add the correct display in IE 9-. - */ - - article, - aside, - footer, - header, - nav, - section { - display: block; - } - - /** - * Correct the font size and margin on `h1` elements within `section` and - * `article` contexts in Chrome, Firefox, and Safari. - */ - - h1 { - @include normalize-font-size($h1-font-size); - @if $normalize-vertical-rhythm { - @include normalize-line-height($h1-font-size); - } - - @if $normalize-vertical-rhythm { - /* Set 1 unit of vertical rhythm on the top and bottom margins. */ - @include normalize-margin(1 0, $h1-font-size); - } - @else { - margin: 0.67em 0; - } - } - - @if $normalize-vertical-rhythm { - h2 { - @include normalize-font-size($h2-font-size); - @include normalize-line-height($h2-font-size); - @include normalize-margin(1 0, $h2-font-size); - } - - h3 { - @include normalize-font-size($h3-font-size); - @include normalize-line-height($h3-font-size); - @include normalize-margin(1 0, $h3-font-size); - } - - h4 { - @include normalize-font-size($h4-font-size); - @include normalize-line-height($h4-font-size); - @include normalize-margin(1 0, $h4-font-size); - } - - h5 { - @include normalize-font-size($h5-font-size); - @include normalize-line-height($h5-font-size); - @include normalize-margin(1 0, $h5-font-size); - } - - h6 { - @include normalize-font-size($h6-font-size); - @include normalize-line-height($h6-font-size); - @include normalize-margin(1 0, $h6-font-size); - } - } - } - - @if _normalize-include(grouping) { - /* Grouping content - ========================================================================== */ - - @if $normalize-vertical-rhythm { - /** - * Set 1 unit of vertical rhythm on the top and bottom margin. - */ - - blockquote { - @include normalize-margin(1 $indent-amount); - } - - dl, - ol, - ul { - @include normalize-margin(1 0); - } - - /** - * Turn off margins on nested lists. - */ - - ol, - ul { - ol, - ul { - margin: 0; - } - } - - dd { - margin: 0 0 0 $indent-amount; - } - - ol, - ul { - padding: 0 0 0 $indent-amount; - } - } - - /** - * Add the correct display in IE 9-. - */ - - figcaption, - figure { - display: block; - } - - /** - * Add the correct margin in IE 8. - */ - - figure { - @if $normalize-vertical-rhythm { - @include normalize-margin(1 $indent-amount); - } - @else { - margin: 1em $indent-amount; - } - } - - /** - * 1. Add the correct box sizing in Firefox. - * 2. Show the overflow in Edge and IE. - */ - - hr { - box-sizing: content-box; /* 1 */ - height: 0; /* 1 */ - overflow: visible; /* 2 */ - } - - /** - * Add the correct display in IE. - */ - - main { - display: block; - } - - @if $normalize-vertical-rhythm { - /** - * Set 1 unit of vertical rhythm on the top and bottom margin. - */ - - p, - pre { - @include normalize-margin(1 0); - } - } - - /** - * 1. Correct the inheritance and scaling of font size in all browsers. - * 2. Correct the odd `em` font sizing in all browsers. - */ - - pre { - font-family: monospace, monospace; /* 1 */ - font-size: 1em; /* 2 */ - } - } - - @if _normalize-include(links) { - /* Links - ========================================================================== */ - - /** - * 1. Remove the gray background on active links in IE 10. - * 2. Remove gaps in links underline in iOS 8+ and Safari 8+. - */ - - a { - background-color: transparent; /* 1 */ - -webkit-text-decoration-skip: objects; /* 2 */ - } - } - - @if _normalize-include(text) { - /* Text-level semantics - ========================================================================== */ - - /** - * 1. Remove the bottom border in Chrome 57- and Firefox 39-. - * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari. - */ - - abbr[title] { - border-bottom: none; /* 1 */ - text-decoration: underline; /* 2 */ - text-decoration: underline dotted; /* 2 */ - } - - /** - * Prevent the duplicate application of `bolder` by the next rule in Safari 6. - */ - - b, - strong { - font-weight: inherit; - } - - /** - * Add the correct font weight in Chrome, Edge, and Safari. - */ - - b, - strong { - font-weight: bolder; - } - - /** - * 1. Correct the inheritance and scaling of font size in all browsers. - * 2. Correct the odd `em` font sizing in all browsers. - */ - - code, - kbd, - samp { - font-family: monospace, monospace; /* 1 */ - font-size: 1em; /* 2 */ - } - - /** - * Add the correct font style in Android 4.3-. - */ - - dfn { - font-style: italic; - } - - /** - * Add the correct background and color in IE 9-. - */ - - mark { - background-color: #ff0; - color: #000; - } - - /** - * Add the correct font size in all browsers. - */ - - small { - font-size: 80%; - } - - /** - * Prevent `sub` and `sup` elements from affecting the line height in - * all browsers. - */ - - sub, - sup { - font-size: 75%; - line-height: 0; - position: relative; - vertical-align: baseline; - } - - sub { - bottom: -0.25em; - } - - sup { - top: -0.5em; - } - } - - @if _normalize-include(embedded) { - /* Embedded content - ========================================================================== */ - - /** - * Add the correct display in IE 9-. - */ - - audio, - video { - display: inline-block; - } - - /** - * Add the correct display in iOS 4-7. - */ - - audio:not([controls]) { - display: none; - height: 0; - } - - /** - * Remove the border on images inside links in IE 10-. - */ - - img { - border-style: none; - } - - /** - * Hide the overflow in IE. - */ - - svg:not(:root) { - overflow: hidden; - } - } - - @if _normalize-include(forms) { - /* Forms - ========================================================================== */ - - /** - * 1. Change the font styles in all browsers (opinionated). - * 2. Remove the margin in Firefox and Safari. - */ - - button, - input, - optgroup, - select, - textarea { - font-family: if($base-font-family, $base-font-family, sans-serif); /* 1 */ - font-size: 100%; /* 1 */ - @if $normalize-vertical-rhythm { - line-height: ($base-line-height / $base-font-size) * 1em; /* 1 */ - } - @else { - line-height: 1.15; /* 1 */ - } - margin: 0; /* 2 */ - } - - /** - * Show the overflow in IE. - */ - - button { - overflow: visible; - } - - /** - * Remove the inheritance of text transform in Edge, Firefox, and IE. - * 1. Remove the inheritance of text transform in Firefox. - */ - - button, - select { /* 1 */ - text-transform: none; - } - - /** - * 1. Prevent a WebKit bug where (2) destroys native `audio` and `video` - * controls in Android 4. - * 2. Correct the inability to style clickable types in iOS and Safari. - */ - - button, - html [type="button"], /* 1 */ - [type="reset"], - [type="submit"] { - -webkit-appearance: button; /* 2 */ - } - - button, - [type="button"], - [type="reset"], - [type="submit"] { - - /** - * Remove the inner border and padding in Firefox. - */ - - &::-moz-focus-inner { - border-style: none; - padding: 0; - } - - /** - * Restore the focus styles unset by the previous rule. - */ - - &:-moz-focusring { - outline: 1px dotted ButtonText; - } - } - - /** - * Show the overflow in Edge. - */ - - input { - overflow: visible; - } - - /** - * 1. Add the correct box sizing in IE 10-. - * 2. Remove the padding in IE 10-. - */ - - [type="checkbox"], - [type="radio"] { - box-sizing: border-box; /* 1 */ - padding: 0; /* 2 */ - } - - /** - * Correct the cursor style of increment and decrement buttons in Chrome. - */ - - [type="number"]::-webkit-inner-spin-button, - [type="number"]::-webkit-outer-spin-button { - height: auto; - } - - /** - * 1. Correct the odd appearance in Chrome and Safari. - * 2. Correct the outline style in Safari. - */ - - [type="search"] { - -webkit-appearance: textfield; /* 1 */ - outline-offset: -2px; /* 2 */ - - /** - * Remove the inner padding and cancel buttons in Chrome and Safari on macOS. - */ - - &::-webkit-search-cancel-button, - &::-webkit-search-decoration { - -webkit-appearance: none; - } - } - - /** - * 1. Correct the inability to style clickable types in iOS and Safari. - * 2. Change font properties to `inherit` in Safari. - */ - - ::-webkit-file-upload-button { - -webkit-appearance: button; /* 1 */ - font: inherit; /* 2 */ - } - - /** - * Correct the padding in Firefox. - */ - - fieldset { - padding: 0.35em 0.75em 0.625em; - } - - /** - * 1. Correct the text wrapping in Edge and IE. - * 2. Correct the color inheritance from `fieldset` elements in IE. - * 3. Remove the padding so developers are not caught out when they zero out - * `fieldset` elements in all browsers. - */ - - legend { - box-sizing: border-box; /* 1 */ - display: table; /* 1 */ - max-width: 100%; /* 1 */ - padding: 0; /* 3 */ - color: inherit; /* 2 */ - white-space: normal; /* 1 */ - } - - /** - * 1. Add the correct display in IE 9-. - * 2. Add the correct vertical alignment in Chrome, Firefox, and Opera. - */ - - progress { - display: inline-block; /* 1 */ - vertical-align: baseline; /* 2 */ - } - - /** - * Remove the default vertical scrollbar in IE. - */ - - textarea { - overflow: auto; - } - } - - @if _normalize-include(interactive) { - /* Interactive - ========================================================================== */ - - /* - * Add the correct display in Edge, IE, and Firefox. - */ - - details { - display: block; - } - - /* - * Add the correct display in all browsers. - */ - - summary { - display: list-item; - } - - /* - * Add the correct display in IE 9-. - */ - - menu { - display: block; - - @if $normalize-vertical-rhythm { - /* - * 1. Set 1 unit of vertical rhythm on the top and bottom margin. - * 2. Set consistent space for the list style image. - */ - - @include normalize-margin(1 0); /* 1 */ - padding: 0 0 0 $indent-amount; /* 2 */ - - /** - * Turn off margins on nested lists. - */ - - menu &, - ol &, - ul & { - margin: 0; - } - } - } - } - - @if _normalize-include(scripting) { - /* Scripting - ========================================================================== */ - - /** - * Add the correct display in IE 9-. - */ - - canvas { - display: inline-block; - } - - /** - * Add the correct display in IE. - */ - - template { - display: none; - } - } - - @if _normalize-include(hidden) { - /* Hidden - ========================================================================== */ - - /** - * Add the correct display in IE 10-. - */ - - [hidden] { - display: none; - } - } -} diff --git a/assets/styles/normalize/_normalize.scss b/assets/styles/normalize/_normalize.scss deleted file mode 100755 index fd669eb9b..000000000 --- a/assets/styles/normalize/_normalize.scss +++ /dev/null @@ -1,3 +0,0 @@ -@import 'normalize/variables'; -@import 'normalize/vertical-rhythm'; -@import 'normalize/normalize-mixin'; diff --git a/assets/styles/normalize/_variables.scss b/assets/styles/normalize/_variables.scss deleted file mode 100755 index 10d05ed76..000000000 --- a/assets/styles/normalize/_variables.scss +++ /dev/null @@ -1,36 +0,0 @@ -// -// Variables -// -// You can override the default values by setting the variables in your Sass -// before importing the normalize-scss library. - -// The font size set on the root html element. -$base-font-size: 16px !default; - -// The base line height determines the basic unit of vertical rhythm. -$base-line-height: 24px !default; - -// The length unit in which to output vertical rhythm values. -// Supported values: px, em, rem. -$base-unit: 'em' !default; - -// The default font family. -$base-font-family: null !default; - -// The font sizes for h1-h6. -$h1-font-size: 2 * $base-font-size !default; -$h2-font-size: 1.5 * $base-font-size !default; -$h3-font-size: 1.17 * $base-font-size !default; -$h4-font-size: 1 * $base-font-size !default; -$h5-font-size: 0.83 * $base-font-size !default; -$h6-font-size: 0.67 * $base-font-size !default; - -// The amount lists and blockquotes are indented. -$indent-amount: 40px !default; - -// The following variable controls whether normalize-scss will output -// font-sizes, line-heights and block-level top/bottom margins that form a basic -// vertical rhythm on the page, which differs from the original Normalize.css. -// However, changing any of the variables above will cause -// $normalize-vertical-rhythm to be automatically set to true. -$normalize-vertical-rhythm: false !default; diff --git a/assets/styles/normalize/_vertical-rhythm.scss b/assets/styles/normalize/_vertical-rhythm.scss deleted file mode 100755 index 4f53647ca..000000000 --- a/assets/styles/normalize/_vertical-rhythm.scss +++ /dev/null @@ -1,61 +0,0 @@ -// -// Vertical Rhythm -// -// This is the minimal amount of code needed to create vertical rhythm in our -// CSS. If you are looking for a robust solution, look at the excellent Typey -// library. @see https://github.com/jptaranto/typey - -@function normalize-rhythm($value, $relative-to: $base-font-size, $unit: $base-unit) { - @if unit($value) != px { - @error "The normalize vertical-rhythm module only supports px inputs. The typey library is better."; - } - @if $unit == rem { - @return ($value / $base-font-size) * 1rem; - } - @else if $unit == em { - @return ($value / $relative-to) * 1em; - } - @else { // $unit == px - @return $value; - } -} - -@mixin normalize-font-size($value, $relative-to: $base-font-size) { - @if unit($value) != 'px' { - @error "normalize-font-size() only supports px inputs. The typey library is better."; - } - font-size: normalize-rhythm($value, $relative-to); -} - -@mixin normalize-rhythm($property, $values, $relative-to: $base-font-size) { - $value-list: $values; - $sep: space; - @if type-of($values) == 'list' { - $sep: list-separator($values); - } - @else { - $value-list: append((), $values); - } - - $normalized-values: (); - @each $value in $value-list { - @if unitless($value) and $value != 0 { - $value: $value * normalize-rhythm($base-line-height, $relative-to); - } - $normalized-values: append($normalized-values, $value, $sep); - } - #{$property}: $normalized-values; -} - -@mixin normalize-margin($values, $relative-to: $base-font-size) { - @include normalize-rhythm(margin, $values, $relative-to); -} - -@mixin normalize-line-height($font-size, $min-line-padding: 2px) { - $lines: ceil($font-size / $base-line-height); - // If lines are cramped include some extra leading. - @if ($lines * $base-line-height - $font-size) < ($min-line-padding * 2) { - $lines: $lines + 1; - } - @include normalize-rhythm(line-height, $lines, $font-size); -} diff --git a/assets/styles/styles-default.scss b/assets/styles/styles-default.scss index d507535fe..a7ef67807 100644 --- a/assets/styles/styles-default.scss +++ b/assets/styles/styles-default.scss @@ -4,14 +4,14 @@ @import "tools/icomoon", "tools/media-queries.scss", "tools/mixins.scss", - "tools/tooltips"; + "tools/tooltips", + "tools/normalize.scss"; // Import default light theme @import "themes/theme-light.scss"; // Import Layout Styles -@import "normalize/import-now", - "layouts/global", +@import "layouts/global", "layouts/top-nav", "layouts/homepage", "layouts/sidebar", diff --git a/assets/styles/tools/_normalize.scss b/assets/styles/tools/_normalize.scss new file mode 100755 index 000000000..91e3e564c --- /dev/null +++ b/assets/styles/tools/_normalize.scss @@ -0,0 +1,427 @@ +/*! normalize.scss v0.1.0 | MIT License | based on git.io/normalize */ + +/** + * 1. Set default font family to sans-serif. + * 2. Prevent iOS text size adjust after orientation change, without disabling + * user zoom. + */ + +html { + font-family: sans-serif; /* 1 */ + -ms-text-size-adjust: 100%; /* 2 */ + -webkit-text-size-adjust: 100%; /* 2 */ +} + +/** + * Remove default margin. + */ + +body { + margin: 0; +} + +/* HTML5 display definitions + ========================================================================== */ + +/** + * Correct `block` display not defined for any HTML5 element in IE 8/9. + * Correct `block` display not defined for `details` or `summary` in IE 10/11 + * and Firefox. + * Correct `block` display not defined for `main` in IE 11. + */ + +article, +aside, +details, +figcaption, +figure, +footer, +header, +hgroup, +main, +menu, +nav, +section, +summary { + display: block; +} + +/** + * 1. Correct `inline-block` display not defined in IE 8/9. + * 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera. + */ + +audio, +canvas, +progress, +video { + display: inline-block; /* 1 */ + vertical-align: baseline; /* 2 */ +} + +/** + * Prevent modern browsers from displaying `audio` without controls. + * Remove excess height in iOS 5 devices. + */ + +audio:not([controls]) { + display: none; + height: 0; +} + +/** + * Address `[hidden]` styling not present in IE 8/9/10. + * Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22. + */ + +[hidden], +template { + display: none; +} + +/* Links + ========================================================================== */ + +/** + * Remove the gray background color from active links in IE 10. + */ + +a { + background-color: transparent; +} + +/** + * Improve readability when focused and also mouse hovered in all browsers. + */ + +a:active, +a:hover { + outline: 0; +} + +/* Text-level semantics + ========================================================================== */ + +/** + * Address styling not present in IE 8/9/10/11, Safari, and Chrome. + */ + +abbr[title] { + border-bottom: 1px dotted; +} + +/** + * Address style set to `bolder` in Firefox 4+, Safari, and Chrome. + */ + +b, +strong { + font-weight: bold; +} + +/** + * Address styling not present in Safari and Chrome. + */ + +dfn { + font-style: italic; +} + +/** + * Address variable `h1` font-size and margin within `section` and `article` + * contexts in Firefox 4+, Safari, and Chrome. + */ + +h1 { + font-size: 2em; + margin: 0.67em 0; +} + +/** + * Address styling not present in IE 8/9. + */ + +mark { + background: #ff0; + color: #000; +} + +/** + * Address inconsistent and variable font size in all browsers. + */ + +small { + font-size: 80%; +} + +/** + * Prevent `sub` and `sup` affecting `line-height` in all browsers. + */ + +sub, +sup { + font-size: 75%; + line-height: 0; + position: relative; + vertical-align: baseline; +} + +sup { + top: -0.5em; +} + +sub { + bottom: -0.25em; +} + +/* Embedded content + ========================================================================== */ + +/** + * Remove border when inside `a` element in IE 8/9/10. + */ + +img { + border: 0; +} + +/** + * Correct overflow not hidden in IE 9/10/11. + */ + +svg:not(:root) { + overflow: hidden; +} + +/* Grouping content + ========================================================================== */ + +/** + * Address margin not present in IE 8/9 and Safari. + */ + +figure { + margin: 1em 40px; +} + +/** + * Address differences between Firefox and other browsers. + */ + +hr { + -moz-box-sizing: content-box; + box-sizing: content-box; + height: 0; +} + +/** + * Contain overflow in all browsers. + */ + +pre { + overflow: auto; +} + +/** + * Address odd `em`-unit font size rendering in all browsers. + */ + +code, +kbd, +pre, +samp { + font-family: monospace, monospace; + font-size: 1em; +} + +/* Forms + ========================================================================== */ + +/** + * Known limitation: by default, Chrome and Safari on OS X allow very limited + * styling of `select`, unless a `border` property is set. + */ + +/** + * 1. Correct color not being inherited. + * Known issue: affects color of disabled elements. + * 2. Correct font properties not being inherited. + * 3. Address margins set differently in Firefox 4+, Safari, and Chrome. + */ + +button, +input, +optgroup, +select, +textarea { + color: inherit; /* 1 */ + font: inherit; /* 2 */ + margin: 0; /* 3 */ +} + +/** + * Address `overflow` set to `hidden` in IE 8/9/10/11. + */ + +button { + overflow: visible; +} + +/** + * Address inconsistent `text-transform` inheritance for `button` and `select`. + * All other form control elements do not inherit `text-transform` values. + * Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera. + * Correct `select` style inheritance in Firefox. + */ + +button, +select { + text-transform: none; +} + +/** + * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` + * and `video` controls. + * 2. Correct inability to style clickable `input` types in iOS. + * 3. Improve usability and consistency of cursor style between image-type + * `input` and others. + */ + +button, +html input[type="button"], /* 1 */ +input[type="reset"], +input[type="submit"] { + -webkit-appearance: button; /* 2 */ + cursor: pointer; /* 3 */ +} + +/** + * Re-set default cursor for disabled elements. + */ + +button[disabled], +html input[disabled] { + cursor: default; +} + +/** + * Remove inner padding and border in Firefox 4+. + */ + +button::-moz-focus-inner, +input::-moz-focus-inner { + border: 0; + padding: 0; +} + +/** + * Address Firefox 4+ setting `line-height` on `input` using `!important` in + * the UA stylesheet. + */ + +input { + line-height: normal; +} + +/** + * It's recommended that you don't attempt to style these elements. + * Firefox's implementation doesn't respect box-sizing, padding, or width. + * + * 1. Address box sizing set to `content-box` in IE 8/9/10. + * 2. Remove excess padding in IE 8/9/10. + */ + +input[type="checkbox"], +input[type="radio"] { + box-sizing: border-box; /* 1 */ + padding: 0; /* 2 */ +} + +/** + * Fix the cursor style for Chrome's increment/decrement buttons. For certain + * `font-size` values of the `input`, it causes the cursor style of the + * decrement button to change from `default` to `text`. + */ + +input[type="number"]::-webkit-inner-spin-button, +input[type="number"]::-webkit-outer-spin-button { + height: auto; +} + +/** + * 1. Address `appearance` set to `searchfield` in Safari and Chrome. + * 2. Address `box-sizing` set to `border-box` in Safari and Chrome + * (include `-moz` to future-proof). + */ + +input[type="search"] { + -webkit-appearance: textfield; /* 1 */ + -moz-box-sizing: content-box; + -webkit-box-sizing: content-box; /* 2 */ + box-sizing: content-box; +} + +/** + * Remove inner padding and search cancel button in Safari and Chrome on OS X. + * Safari (but not Chrome) clips the cancel button when the search input has + * padding (and `textfield` appearance). + */ + +input[type="search"]::-webkit-search-cancel-button, +input[type="search"]::-webkit-search-decoration { + -webkit-appearance: none; +} + +/** + * Define consistent border, margin, and padding. + */ + +fieldset { + border: 1px solid #c0c0c0; + margin: 0 2px; + padding: 0.35em 0.625em 0.75em; +} + +/** + * 1. Correct `color` not being inherited in IE 8/9/10/11. + * 2. Remove padding so people aren't caught out if they zero out fieldsets. + */ + +legend { + border: 0; /* 1 */ + padding: 0; /* 2 */ +} + +/** + * Remove default vertical scrollbar in IE 8/9/10/11. + */ + +textarea { + overflow: auto; +} + +/** + * Don't inherit the `font-weight` (applied by a rule above). + * NOTE: the default cannot safely be changed in Chrome and Safari on OS X. + */ + +optgroup { + font-weight: bold; +} + +/* Tables + ========================================================================== */ + +/** + * Remove most spacing between table cells. + */ + +table { + border-collapse: collapse; + border-spacing: 0; +} + +td, +th { + padding: 0; +} \ No newline at end of file diff --git a/content/enterprise_influxdb/v1.8/install-and-deploy/_index.md b/content/enterprise_influxdb/v1.8/install-and-deploy/_index.md index 70d2179ec..ae921efcf 100644 --- a/content/enterprise_influxdb/v1.8/install-and-deploy/_index.md +++ b/content/enterprise_influxdb/v1.8/install-and-deploy/_index.md @@ -11,8 +11,8 @@ menu: Install or deploy your InfluxDB Enterprise cluster in the environment of your choice: -- [Your own environment](#your-production-environment) -- [Your cloud provider](#your-cloud-provider) +- Your own environment +- Your cloud provider ## Your production environment diff --git a/content/influxdb/v1.7/about_the_project/releasenotes-changelog.md b/content/influxdb/v1.7/about_the_project/releasenotes-changelog.md index 58b636049..cd0989c73 100644 --- a/content/influxdb/v1.7/about_the_project/releasenotes-changelog.md +++ b/content/influxdb/v1.7/about_the_project/releasenotes-changelog.md @@ -5,6 +5,7 @@ menu: name: Release notes weight: 10 parent: About the project +v2: /influxdb/v2.0/reference/release-notes/influxdb/ --- ## v1.7.10 [2020-02-07] diff --git a/content/influxdb/v1.7/administration/authentication_and_authorization.md b/content/influxdb/v1.7/administration/authentication_and_authorization.md index a0d577498..6257b1ee6 100644 --- a/content/influxdb/v1.7/administration/authentication_and_authorization.md +++ b/content/influxdb/v1.7/administration/authentication_and_authorization.md @@ -7,6 +7,7 @@ menu: name: Authentication and authorization weight: 20 parent: Administration +v2: /influxdb/v2.0/security/tokens/ --- This document covers setting up and managing authentication and authorization in InfluxDB. @@ -32,7 +33,7 @@ This document covers setting up and managing authentication and authorization in > **Note:** Authentication and authorization should not be relied upon to prevent access and protect data from malicious actors. If additional security or compliance features are desired, InfluxDB should be run behind a third-party service. If InfluxDB -is being deployed on a publicly accessible endpoint, we strongly recommend authentication be enabled. Otherwise the data will +is being deployed on a publicly accessible endpoint, we strongly recommend authentication be enabled. Otherwise the data will be publicly available to any unauthenticated user. ## Authentication diff --git a/content/influxdb/v1.7/administration/backup_and_restore.md b/content/influxdb/v1.7/administration/backup_and_restore.md index c4a728b3b..b8964882b 100644 --- a/content/influxdb/v1.7/administration/backup_and_restore.md +++ b/content/influxdb/v1.7/administration/backup_and_restore.md @@ -8,6 +8,7 @@ menu: name: Backing up and restoring weight: 60 parent: Administration +v2: /influxdb/v2.0/backup-restore/ --- ## Overview diff --git a/content/influxdb/v1.7/administration/config.md b/content/influxdb/v1.7/administration/config.md index 443f53c10..0e61ff740 100644 --- a/content/influxdb/v1.7/administration/config.md +++ b/content/influxdb/v1.7/administration/config.md @@ -5,6 +5,7 @@ menu: name: Configuring InfluxDB weight: 10 parent: Administration +v2: /influxdb/v2.0/reference/config-options/ --- The InfluxDB open source (OSS) configuration file contains configuration settings specific to a local node. diff --git a/content/influxdb/v1.7/administration/https_setup.md b/content/influxdb/v1.7/administration/https_setup.md index 29edefe00..4f90b3ab5 100644 --- a/content/influxdb/v1.7/administration/https_setup.md +++ b/content/influxdb/v1.7/administration/https_setup.md @@ -6,6 +6,7 @@ menu: name: Enabling HTTPS weight: 30 parent: Administration +v2: /influxdb/v2.0/security/enable-tls/ --- Enable TLS to encrypt communication between clients and the InfluxDB server. diff --git a/content/influxdb/v1.7/administration/security.md b/content/influxdb/v1.7/administration/security.md index d4d0de8dc..3fec37bb2 100644 --- a/content/influxdb/v1.7/administration/security.md +++ b/content/influxdb/v1.7/administration/security.md @@ -5,6 +5,7 @@ menu: name: Managing security weight: 70 parent: Administration +v2: /influxdb/v2.0/security/ --- Some customers may choose to install InfluxDB with public internet access, however diff --git a/content/influxdb/v1.7/concepts/_index.md b/content/influxdb/v1.7/concepts/_index.md index 5404a3511..cd6898c47 100644 --- a/content/influxdb/v1.7/concepts/_index.md +++ b/content/influxdb/v1.7/concepts/_index.md @@ -4,7 +4,7 @@ menu: influxdb_1_7: name: Concepts weight: 30 - +v2: /influxdb/v2.0/reference/key-concepts/ --- Understanding the following concepts will help you get the most out of InfluxDB. diff --git a/content/influxdb/v1.7/concepts/glossary.md b/content/influxdb/v1.7/concepts/glossary.md index 8ba1b83a1..b8263aa42 100644 --- a/content/influxdb/v1.7/concepts/glossary.md +++ b/content/influxdb/v1.7/concepts/glossary.md @@ -5,6 +5,8 @@ menu: name: Glossary weight: 20 parent: Concepts +canonical: /{{< latest "influxdb" "v2" >}}/reference/glossary/ +v2: /influxdb/v2.0/reference/glossary/ --- ## aggregation diff --git a/content/influxdb/v1.7/concepts/insights_tradeoffs.md b/content/influxdb/v1.7/concepts/insights_tradeoffs.md index a9260300e..ec734b94e 100644 --- a/content/influxdb/v1.7/concepts/insights_tradeoffs.md +++ b/content/influxdb/v1.7/concepts/insights_tradeoffs.md @@ -5,6 +5,7 @@ menu: name: InfluxDB design insights and tradeoffs weight: 40 parent: Concepts +v2: /influxdb/v2.0/reference/key-concepts/design-principles/ --- InfluxDB is a time series database. diff --git a/content/influxdb/v1.7/concepts/key_concepts.md b/content/influxdb/v1.7/concepts/key_concepts.md index eb7c1949b..9af8e71c5 100644 --- a/content/influxdb/v1.7/concepts/key_concepts.md +++ b/content/influxdb/v1.7/concepts/key_concepts.md @@ -6,6 +6,7 @@ menu: name: Key concepts weight: 10 parent: Concepts +v2: /influxdb/v2.0/reference/key-concepts/ --- Before diving into InfluxDB it's good to get acquainted with some of the key concepts of the database. diff --git a/content/influxdb/v1.7/concepts/storage_engine.md b/content/influxdb/v1.7/concepts/storage_engine.md index 5556eb09d..b3fe1e8f0 100644 --- a/content/influxdb/v1.7/concepts/storage_engine.md +++ b/content/influxdb/v1.7/concepts/storage_engine.md @@ -6,6 +6,7 @@ menu: name: In-memory indexing with TSM weight: 60 parent: Concepts +v2: /influxdb/v2.0/reference/internals/storage-engine/ --- ## The InfluxDB storage engine and the Time-Structured Merge Tree (TSM) diff --git a/content/influxdb/v1.7/flux/_index.md b/content/influxdb/v1.7/flux/_index.md index 88bb1f370..6bb97b888 100644 --- a/content/influxdb/v1.7/flux/_index.md +++ b/content/influxdb/v1.7/flux/_index.md @@ -6,6 +6,7 @@ menu: influxdb_1_7: name: Flux weight: 80 +v2: /influxdb/v2.0/query-data/get-started/ --- Flux is a functional data scripting language designed for querying, analyzing, and acting on time series data. diff --git a/content/influxdb/v1.7/flux/get-started/_index.md b/content/influxdb/v1.7/flux/get-started/_index.md index 41c2b51f5..20e01d06b 100644 --- a/content/influxdb/v1.7/flux/get-started/_index.md +++ b/content/influxdb/v1.7/flux/get-started/_index.md @@ -11,6 +11,8 @@ menu: weight: 2 aliases: - /influxdb/v1.7/flux/getting-started/ +canonical: /{{< latest "influxdb" "v2" >}}/query-data/get-started/ +v2: /influxdb/v2.0/query-data/get-started/ --- Flux is InfluxData's new functional data scripting language designed for querying, diff --git a/content/influxdb/v1.7/flux/get-started/query-influxdb.md b/content/influxdb/v1.7/flux/get-started/query-influxdb.md index e029189ce..d5aa5236e 100644 --- a/content/influxdb/v1.7/flux/get-started/query-influxdb.md +++ b/content/influxdb/v1.7/flux/get-started/query-influxdb.md @@ -8,6 +8,8 @@ menu: weight: 1 aliases: - /influxdb/v1.7/flux/getting-started/query-influxdb/ +canonical: /{{< latest "influxdb" "v2" >}}/query-data/get-started/query-influxdb/ +v2: /influxdb/v2.0/query-data/get-started/query-influxdb/ --- This guide walks through the basics of using Flux to query data from InfluxDB. diff --git a/content/influxdb/v1.7/flux/get-started/syntax-basics.md b/content/influxdb/v1.7/flux/get-started/syntax-basics.md index 2b625b44a..1aa95a235 100644 --- a/content/influxdb/v1.7/flux/get-started/syntax-basics.md +++ b/content/influxdb/v1.7/flux/get-started/syntax-basics.md @@ -8,6 +8,8 @@ menu: weight: 3 aliases: - /influxdb/v1.7/flux/getting-started/syntax-basics/ +canonical: /{{< latest "influxdb" "v2" >}}/query-data/get-started/syntax-basics/ +v2: /influxdb/v2.0/query-data/get-started/syntax-basics/ --- diff --git a/content/influxdb/v1.7/flux/get-started/transform-data.md b/content/influxdb/v1.7/flux/get-started/transform-data.md index 7c0e0b3d6..f56f11c15 100644 --- a/content/influxdb/v1.7/flux/get-started/transform-data.md +++ b/content/influxdb/v1.7/flux/get-started/transform-data.md @@ -8,6 +8,8 @@ menu: weight: 2 aliases: - /influxdb/v1.7/flux/getting-started/transform-data/ +canonical: /{{< latest "influxdb" "v2" >}}/query-data/get-started/transform-data/ +v2: /influxdb/v2.0/query-data/get-started/transform-data/ --- When [querying data from InfluxDB](/influxdb/v1.7/flux/get-started/query-influxdb), diff --git a/content/influxdb/v1.7/flux/guides/_index.md b/content/influxdb/v1.7/flux/guides/_index.md index 965cafaf7..713b141fe 100644 --- a/content/influxdb/v1.7/flux/guides/_index.md +++ b/content/influxdb/v1.7/flux/guides/_index.md @@ -6,6 +6,8 @@ menu: influxdb_1_7: name: Query with Flux parent: Flux +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/ +v2: /influxdb/v2.0/query-data/flux/ --- The following guides walk through both common and complex queries and use cases for Flux. diff --git a/content/influxdb/v1.7/flux/guides/calculate-percentages.md b/content/influxdb/v1.7/flux/guides/calculate-percentages.md index 9db9b7d3f..8233feef2 100644 --- a/content/influxdb/v1.7/flux/guides/calculate-percentages.md +++ b/content/influxdb/v1.7/flux/guides/calculate-percentages.md @@ -9,6 +9,8 @@ menu: parent: Query with Flux weight: 6 list_query_example: percentages +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/calculate-percentages/ +v2: /influxdb/v2.0/query-data/flux/calculate-percentages/ --- Calculating percentages from queried data is a common use case for time series data. diff --git a/content/influxdb/v1.7/flux/guides/conditional-logic.md b/content/influxdb/v1.7/flux/guides/conditional-logic.md index fef58a079..1faa4e94d 100644 --- a/content/influxdb/v1.7/flux/guides/conditional-logic.md +++ b/content/influxdb/v1.7/flux/guides/conditional-logic.md @@ -10,6 +10,8 @@ menu: name: Conditional logic parent: Query with Flux weight: 20 +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/conditional-logic/ +v2: /influxdb/v2.0/query-data/flux/conditional-logic/ list_code_example: | ```js if color == "green" then "008000" else "ffffff" diff --git a/content/influxdb/v1.7/flux/guides/cumulativesum.md b/content/influxdb/v1.7/flux/guides/cumulativesum.md index 509b489cb..6d7138784 100644 --- a/content/influxdb/v1.7/flux/guides/cumulativesum.md +++ b/content/influxdb/v1.7/flux/guides/cumulativesum.md @@ -10,6 +10,8 @@ menu: parent: Query with Flux name: Cumulative sum list_query_example: cumulative_sum +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/cumulativesum/ +v2: /influxdb/v2.0/query-data/flux/cumulativesum/ --- Use the [`cumulativeSum()` function](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/cumulativesum/) diff --git a/content/influxdb/v1.7/flux/guides/execute-queries.md b/content/influxdb/v1.7/flux/guides/execute-queries.md index 00d66163e..6bfd352fa 100644 --- a/content/influxdb/v1.7/flux/guides/execute-queries.md +++ b/content/influxdb/v1.7/flux/guides/execute-queries.md @@ -8,6 +8,7 @@ menu: weight: 1 aliases: - /influxdb/v1.7/flux/guides/executing-queries/ +v2: /influxdb/v2.0/query-data/execute-queries/ --- There are multiple ways to execute Flux queries with InfluxDB and Chronograf v1.7+. diff --git a/content/influxdb/v1.7/flux/guides/exists.md b/content/influxdb/v1.7/flux/guides/exists.md index 7e297be0f..b21b67d18 100644 --- a/content/influxdb/v1.7/flux/guides/exists.md +++ b/content/influxdb/v1.7/flux/guides/exists.md @@ -10,6 +10,8 @@ menu: name: Exists parent: Query with Flux weight: 20 +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/exists/ +v2: /influxdb/v2.0/query-data/flux/exists/ list_code_example: | ##### Filter null values ```js diff --git a/content/influxdb/v1.7/flux/guides/fill.md b/content/influxdb/v1.7/flux/guides/fill.md index b39b32c64..ed8127c36 100644 --- a/content/influxdb/v1.7/flux/guides/fill.md +++ b/content/influxdb/v1.7/flux/guides/fill.md @@ -10,6 +10,8 @@ menu: parent: Query with Flux name: Fill list_query_example: fill_null +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/fill/ +v2: /influxdb/v2.0/query-data/flux/fill/ --- Use the [`fill()` function](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/fill/) diff --git a/content/influxdb/v1.7/flux/guides/first-last.md b/content/influxdb/v1.7/flux/guides/first-last.md index 3b790dfb3..247c500bd 100644 --- a/content/influxdb/v1.7/flux/guides/first-last.md +++ b/content/influxdb/v1.7/flux/guides/first-last.md @@ -10,6 +10,8 @@ menu: parent: Query with Flux name: First & last list_query_example: first_last +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/first-last/ +v2: /influxdb/v2.0/query-data/flux/first-last/ --- Use the [`first()`](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/first/) or diff --git a/content/influxdb/v1.7/flux/guides/flux-in-dashboards.md b/content/influxdb/v1.7/flux/guides/flux-in-dashboards.md index 591e028ed..db763a70b 100644 --- a/content/influxdb/v1.7/flux/guides/flux-in-dashboards.md +++ b/content/influxdb/v1.7/flux/guides/flux-in-dashboards.md @@ -8,6 +8,8 @@ menu: name: Use Flux in dashboards parent: Query with Flux weight: 30 +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/flux-in-dashboards/ +v2: /influxdb/v2.0/query-data/flux/flux-in-dashboards/ --- [Chronograf](/{{< latest "chronograf" >}}/) is the web user interface for managing for the diff --git a/content/influxdb/v1.7/flux/guides/group-data.md b/content/influxdb/v1.7/flux/guides/group-data.md index 773686755..7621ec77e 100644 --- a/content/influxdb/v1.7/flux/guides/group-data.md +++ b/content/influxdb/v1.7/flux/guides/group-data.md @@ -11,6 +11,8 @@ weight: 2 aliases: - /influxdb/v1.7/flux/guides/grouping-data/ list_query_example: group +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/group-data/ +v2: /influxdb/v2.0/query-data/flux/group-data/ --- With Flux, you can group data by any column in your queried data set. diff --git a/content/influxdb/v1.7/flux/guides/histograms.md b/content/influxdb/v1.7/flux/guides/histograms.md index 8ad374ae7..9dd99214c 100644 --- a/content/influxdb/v1.7/flux/guides/histograms.md +++ b/content/influxdb/v1.7/flux/guides/histograms.md @@ -9,6 +9,8 @@ menu: parent: Query with Flux weight: 10 list_query_example: histogram +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/histograms/ +v2: /influxdb/v2.0/query-data/flux/histograms/ --- Histograms provide valuable insight into the distribution of your data. diff --git a/content/influxdb/v1.7/flux/guides/increase.md b/content/influxdb/v1.7/flux/guides/increase.md index ca545a247..c3c0ab060 100644 --- a/content/influxdb/v1.7/flux/guides/increase.md +++ b/content/influxdb/v1.7/flux/guides/increase.md @@ -12,6 +12,8 @@ menu: parent: Query with Flux name: Increase list_query_example: increase +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/increase/ +v2: /influxdb/v2.0/query-data/flux/increase/ --- Use the [`increase()` function](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/increase/) diff --git a/content/influxdb/v1.7/flux/guides/join.md b/content/influxdb/v1.7/flux/guides/join.md index 16b184f3e..bf0705d40 100644 --- a/content/influxdb/v1.7/flux/guides/join.md +++ b/content/influxdb/v1.7/flux/guides/join.md @@ -9,6 +9,8 @@ menu: parent: Query with Flux weight: 10 list_query_example: join +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/join/ +v2: /influxdb/v2.0/query-data/flux/join/ --- The [`join()` function](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/join) merges two or more diff --git a/content/influxdb/v1.7/flux/guides/manipulate-timestamps.md b/content/influxdb/v1.7/flux/guides/manipulate-timestamps.md index e087a4698..3bce05a44 100644 --- a/content/influxdb/v1.7/flux/guides/manipulate-timestamps.md +++ b/content/influxdb/v1.7/flux/guides/manipulate-timestamps.md @@ -8,6 +8,8 @@ menu: name: Manipulate timestamps parent: Query with Flux weight: 20 +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/manipulate-timestamps/ +v2: /influxdb/v2.0/query-data/flux/manipulate-timestamps/ --- Every point stored in InfluxDB has an associated timestamp. diff --git a/content/influxdb/v1.7/flux/guides/mathematic-operations.md b/content/influxdb/v1.7/flux/guides/mathematic-operations.md index 4845bdfb5..ccb9a429f 100644 --- a/content/influxdb/v1.7/flux/guides/mathematic-operations.md +++ b/content/influxdb/v1.7/flux/guides/mathematic-operations.md @@ -10,6 +10,8 @@ menu: parent: Query with Flux weight: 5 list_query_example: map_math +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/mathematic-operations/ +v2: /influxdb/v2.0/query-data/flux/mathematic-operations/ --- Flux supports mathematic expressions in data transformations. diff --git a/content/influxdb/v1.7/flux/guides/median.md b/content/influxdb/v1.7/flux/guides/median.md index 170decb46..3568b6112 100644 --- a/content/influxdb/v1.7/flux/guides/median.md +++ b/content/influxdb/v1.7/flux/guides/median.md @@ -10,6 +10,8 @@ menu: parent: Query with Flux name: Median list_query_example: median +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/median/ +v2: /influxdb/v2.0/query-data/flux/median/ --- Use the [`median()` function](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/median/) diff --git a/content/influxdb/v1.7/flux/guides/monitor-states.md b/content/influxdb/v1.7/flux/guides/monitor-states.md index 270e7bb80..71d9c7d3f 100644 --- a/content/influxdb/v1.7/flux/guides/monitor-states.md +++ b/content/influxdb/v1.7/flux/guides/monitor-states.md @@ -7,6 +7,8 @@ menu: name: Monitor states parent: Query with Flux weight: 20 +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/monitor-states/ +v2: /influxdb/v2.0/query-data/flux/monitor-states/ --- Flux helps you monitor states in your metrics and events: diff --git a/content/influxdb/v1.7/flux/guides/moving-average.md b/content/influxdb/v1.7/flux/guides/moving-average.md index a57862570..2b662e32a 100644 --- a/content/influxdb/v1.7/flux/guides/moving-average.md +++ b/content/influxdb/v1.7/flux/guides/moving-average.md @@ -10,6 +10,8 @@ menu: parent: Query with Flux name: Moving Average list_query_example: moving_average +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/moving-average/ +v2: /influxdb/v2.0/query-data/flux/moving-average/ --- Use the [`movingAverage()`](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/movingaverage/) diff --git a/content/influxdb/v1.7/flux/guides/optimize-queries.md b/content/influxdb/v1.7/flux/guides/optimize-queries.md index c3689c94f..d8a0a72dc 100644 --- a/content/influxdb/v1.7/flux/guides/optimize-queries.md +++ b/content/influxdb/v1.7/flux/guides/optimize-queries.md @@ -7,6 +7,8 @@ menu: influxdb_1_7: name: Optimize queries parent: Query with Flux +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/optimize-queries/ +v2: /influxdb/v2.0/query-data/flux/optimize-queries/ --- Optimize your Flux queries to reduce their memory and compute (CPU) requirements. diff --git a/content/influxdb/v1.7/flux/guides/percentile-quantile.md b/content/influxdb/v1.7/flux/guides/percentile-quantile.md index 444a5c9be..c2cd41005 100644 --- a/content/influxdb/v1.7/flux/guides/percentile-quantile.md +++ b/content/influxdb/v1.7/flux/guides/percentile-quantile.md @@ -11,6 +11,8 @@ menu: parent: Query with Flux name: Percentile & quantile list_query_example: quantile +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/percentile-quantile/ +v2: /influxdb/v2.0/query-data/flux/percentile-quantile/ --- Use the [`quantile()` function](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/quantile/) diff --git a/content/influxdb/v1.7/flux/guides/query-fields.md b/content/influxdb/v1.7/flux/guides/query-fields.md index a77403a1b..2d68b8bb8 100644 --- a/content/influxdb/v1.7/flux/guides/query-fields.md +++ b/content/influxdb/v1.7/flux/guides/query-fields.md @@ -9,6 +9,8 @@ weight: 1 menu: influxdb_1_7: parent: Query with Flux +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/query-fields/ +v2: /influxdb/v2.0/query-data/flux/query-fields/ list_code_example: | ```js from(bucket: "db/rp") diff --git a/content/influxdb/v1.7/flux/guides/rate.md b/content/influxdb/v1.7/flux/guides/rate.md index 27dabfe2e..8f5dcbd73 100644 --- a/content/influxdb/v1.7/flux/guides/rate.md +++ b/content/influxdb/v1.7/flux/guides/rate.md @@ -13,6 +13,8 @@ menu: parent: Query with Flux name: Rate list_query_example: rate_of_change +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/rate/ +v2: /influxdb/v2.0/query-data/flux/rate/ --- diff --git a/content/influxdb/v1.7/flux/guides/regular-expressions.md b/content/influxdb/v1.7/flux/guides/regular-expressions.md index c1444099d..b09600cb5 100644 --- a/content/influxdb/v1.7/flux/guides/regular-expressions.md +++ b/content/influxdb/v1.7/flux/guides/regular-expressions.md @@ -8,6 +8,8 @@ menu: parent: Query with Flux weight: 20 list_query_example: regular_expressions +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/regular-expressions/ +v2: /influxdb/v2.0/query-data/flux/regular-expressions/ --- Regular expressions (regexes) are incredibly powerful when matching patterns in large collections of data. diff --git a/content/influxdb/v1.7/flux/guides/scalar-values.md b/content/influxdb/v1.7/flux/guides/scalar-values.md index 010ce2f51..2f9edd39d 100644 --- a/content/influxdb/v1.7/flux/guides/scalar-values.md +++ b/content/influxdb/v1.7/flux/guides/scalar-values.md @@ -9,6 +9,8 @@ menu: name: Extract scalar values parent: Query with Flux weight: 20 +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/scalar-values/ +v2: /influxdb/v2.0/query-data/flux/scalar-values/ list_code_example: | ```js scalarValue = { diff --git a/content/influxdb/v1.7/flux/guides/sort-limit.md b/content/influxdb/v1.7/flux/guides/sort-limit.md index 8a35dfff8..2a84f10c2 100644 --- a/content/influxdb/v1.7/flux/guides/sort-limit.md +++ b/content/influxdb/v1.7/flux/guides/sort-limit.md @@ -11,6 +11,8 @@ menu: parent: Query with Flux weight: 3 list_query_example: sort_limit +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/sort-limit/ +v2: /influxdb/v2.0/query-data/flux/sort-limit/ --- Use the [`sort()`function](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/sort) diff --git a/content/influxdb/v1.7/flux/guides/sql.md b/content/influxdb/v1.7/flux/guides/sql.md index f72d4a45c..5af40fe97 100644 --- a/content/influxdb/v1.7/flux/guides/sql.md +++ b/content/influxdb/v1.7/flux/guides/sql.md @@ -10,6 +10,8 @@ menu: parent: Query with Flux list_title: SQL data weight: 20 +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/sql/ +v2: /influxdb/v2.0/query-data/flux/sql/ list_code_example: | ```js import "sql" diff --git a/content/influxdb/v1.7/flux/guides/window-aggregate.md b/content/influxdb/v1.7/flux/guides/window-aggregate.md index 75f77d063..c4c1b4eec 100644 --- a/content/influxdb/v1.7/flux/guides/window-aggregate.md +++ b/content/influxdb/v1.7/flux/guides/window-aggregate.md @@ -11,6 +11,8 @@ menu: parent: Query with Flux weight: 4 list_query_example: aggregate_window +canonical: /{{< latest "influxdb" "v2" >}}/query-data/flux/window-aggregate/ +v2: /influxdb/v2.0/query-data/flux/window-aggregate/ --- A common operation performed with time series data is grouping data into windows of time, diff --git a/content/influxdb/v1.7/guides/calculating_percentages.md b/content/influxdb/v1.7/guides/calculating_percentages.md index 129a136e1..e41b46396 100644 --- a/content/influxdb/v1.7/guides/calculating_percentages.md +++ b/content/influxdb/v1.7/guides/calculating_percentages.md @@ -5,6 +5,7 @@ menu: influxdb_1_7: weight: 50 parent: Guides +v2: /influxdb/v2.0/query-data/flux/calculate-percentages/ --- [InfluxQL](/influxdb/v1.7/query_language/) lets you perform simple math equations diff --git a/content/influxdb/v1.7/guides/downsampling_and_retention.md b/content/influxdb/v1.7/guides/downsampling_and_retention.md index e767931ae..76020cc63 100644 --- a/content/influxdb/v1.7/guides/downsampling_and_retention.md +++ b/content/influxdb/v1.7/guides/downsampling_and_retention.md @@ -4,6 +4,7 @@ menu: influxdb_1_7: weight: 30 parent: Guides +v2: /influxdb/v2.0/process-data/common-tasks/downsample-data/ --- InfluxDB can handle hundreds of thousands of data points per second. diff --git a/content/influxdb/v1.7/guides/querying_data.md b/content/influxdb/v1.7/guides/querying_data.md index 8d174c349..76fc27bc5 100644 --- a/content/influxdb/v1.7/guides/querying_data.md +++ b/content/influxdb/v1.7/guides/querying_data.md @@ -6,6 +6,7 @@ menu: influxdb_1_7: weight: 20 parent: Guides +v2: /influxdb/v2.0/query-data/ --- ## Querying data with the InfluxDB API diff --git a/content/influxdb/v1.7/guides/writing_data.md b/content/influxdb/v1.7/guides/writing_data.md index 6029c251d..cf77adc4f 100644 --- a/content/influxdb/v1.7/guides/writing_data.md +++ b/content/influxdb/v1.7/guides/writing_data.md @@ -5,6 +5,7 @@ menu: influxdb_1_7: weight: 10 parent: Guides +v2: /influxdb/v2.0/write-data/ --- Write data into InfluxDB using the [command line interface](/influxdb/v1.7/tools/shell/), [client libraries](/influxdb/v1.7/clients/api/), and plugins for common data formats such as [Graphite](/influxdb/v1.7/write_protocols/graphite/). @@ -49,17 +50,17 @@ Anything that has to do with time in InfluxDB is always UTC. ### Configure gzip compression -InfluxDB supports gzip compression. To reduce network traffic, consider the following options: +InfluxDB supports gzip compression. To reduce network traffic, consider the following options: * To accept compressed data from InfluxDB, add the `Accept-Encoding: gzip` header to InfluxDB API requests. * To compress data before sending it to InfluxDB, add the `Content-Encoding: gzip` header to InfluxDB API requests. -For details about enabling gzip for client libraries, see your client library documentation. - +For details about enabling gzip for client libraries, see your client library documentation. + #### Enable gzip compression in the Telegraf InfluxDB output plugin - -* In the Telegraf configuration file (telegraf.conf), under [[outputs.influxdb]], change + +* In the Telegraf configuration file (telegraf.conf), under [[outputs.influxdb]], change `content_encoding = "identity"` (default) to `content_encoding = "gzip"` >**Note** diff --git a/content/influxdb/v1.7/introduction/getting-started.md b/content/influxdb/v1.7/introduction/getting-started.md index a411861b3..4a0506815 100644 --- a/content/influxdb/v1.7/introduction/getting-started.md +++ b/content/influxdb/v1.7/introduction/getting-started.md @@ -7,6 +7,7 @@ menu: name: Getting started weight: 30 parent: Introduction +v2: /influxdb/v2.0/get-started/ --- With InfluxDB open source (OSS) [installed](/influxdb/v1.7/introduction/installation), you're ready to start doing some awesome things. diff --git a/content/influxdb/v1.7/query_language/continuous_queries.md b/content/influxdb/v1.7/query_language/continuous_queries.md index fb4a0b691..60e0c166f 100644 --- a/content/influxdb/v1.7/query_language/continuous_queries.md +++ b/content/influxdb/v1.7/query_language/continuous_queries.md @@ -6,6 +6,7 @@ menu: name: Continuous Queries weight: 50 parent: InfluxQL +v2: /influxdb/v2.0/process-data/ --- ## Introduction @@ -405,7 +406,7 @@ See [ Description of Basic Syntax](/influxdb/v1.7/query_language/continuous_quer ##### Scheduling and coverage CQs operate on real-time data. With the advanced syntax, CQs use the local -server’s timestamp, the information in the `RESAMPLE` clause, and the InfluxDB +server’s timestamp, the information in the `RESAMPLE` clause, and the InfluxDB server's preset time boundaries to determine when to execute and what time range to cover in the query. diff --git a/content/influxdb/v1.7/query_language/data_download.md b/content/influxdb/v1.7/query_language/data_download.md index 8bc98046b..51f4dc2bf 100644 --- a/content/influxdb/v1.7/query_language/data_download.md +++ b/content/influxdb/v1.7/query_language/data_download.md @@ -6,12 +6,13 @@ menu: parent: InfluxQL aliases: - /influxdb/v1.7/sample_data/data_download/ +v2: /influxdb/v2.0/reference/sample-data/ --- In order to explore the query language further, these instructions help you create a database, download and write data to that database within your InfluxDB installation. -The sample data is then used and referenced in [Data Exploration](../../query_language/data_exploration/), -[Schema Exploration](../../query_language/schema_exploration/), and [Functions](../../query_language/functions/). +The sample data is then used and referenced in [Data Exploration](/influxdb/v1.7/query_language/data_exploration/), +[Schema Exploration](/influxdb/v1.7/query_language/schema_exploration/), and [Functions](/influxdb/v1.7/query_language/functions/). ## Creating a database @@ -60,7 +61,7 @@ From your terminal, download the text file that contains the data in [line proto curl https://s3.amazonaws.com/noaa.water-database/NOAA_data.txt -o NOAA_data.txt ``` -Write the data to InfluxDB via the [CLI](../../tools/shell/): +Write the data to InfluxDB via the [CLI](/influxdb/v1.7/tools/shell/): ``` influx -import -path=NOAA_data.txt -precision=s -database=NOAA_water_database ``` @@ -114,8 +115,8 @@ The sample data is publicly available data from the [National Oceanic and Atmosp The data include 15,258 observations of water levels (ft) collected every six minutes at two stations (Santa Monica, CA (ID 9410840) and Coyote Creek, CA (ID 9414575)) over the period from August 18, 2015 through September 18, 2015. Note that the measurements `average_temperature`, `h2o_pH`, `h2o_quality`, and `h2o_temperature` contain fictional data. -Those measurements serve to illuminate query functionality in [Schema Exploration](../../query_language/schema_exploration/). +Those measurements serve to illuminate query functionality in [Schema Exploration](/influxdb/v1.7/query_language/schema_exploration/). The `h2o_feet` measurement is the only measurement that contains the NOAA data. -Please note that the `level description` field isn't part of the original NOAA data - we snuck it in there for the sake of having a field key with a special character and string [field values](../../concepts/glossary/#field-value). +Please note that the `level description` field isn't part of the original NOAA data - we snuck it in there for the sake of having a field key with a special character and string [field values](/influxdb/v1.7/concepts/glossary/#field-value). diff --git a/content/influxdb/v1.7/query_language/data_exploration.md b/content/influxdb/v1.7/query_language/data_exploration.md index 6f38c0b6d..6c6be8add 100644 --- a/content/influxdb/v1.7/query_language/data_exploration.md +++ b/content/influxdb/v1.7/query_language/data_exploration.md @@ -6,6 +6,7 @@ menu: name: Data exploration weight: 20 parent: InfluxQL +v2: /influxdb/v2.0/query-data/flux/query-fields/ --- InfluxQL is an SQL-like query language for interacting with data in InfluxDB. diff --git a/content/influxdb/v1.7/query_language/schema_exploration.md b/content/influxdb/v1.7/query_language/schema_exploration.md index 84010078e..b945c136e 100644 --- a/content/influxdb/v1.7/query_language/schema_exploration.md +++ b/content/influxdb/v1.7/query_language/schema_exploration.md @@ -5,6 +5,7 @@ menu: name: Schema exploration weight: 30 parent: InfluxQL +v2: /influxdb/v2.0/query-data/flux/explore-schema/ --- InfluxQL is an SQL-like query language for interacting with data in InfluxDB. diff --git a/content/influxdb/v1.7/tools/_index.md b/content/influxdb/v1.7/tools/_index.md index 82055387b..a0f14a46b 100644 --- a/content/influxdb/v1.7/tools/_index.md +++ b/content/influxdb/v1.7/tools/_index.md @@ -7,7 +7,7 @@ menu: influxdb_1_7: name: Tools weight: 60 - +v2: /influxdb/v2.0/tools/ --- This section covers the available tools for interacting with InfluxDB. diff --git a/content/influxdb/v1.7/tools/api.md b/content/influxdb/v1.7/tools/api.md index ea54a83f4..45dc5f640 100644 --- a/content/influxdb/v1.7/tools/api.md +++ b/content/influxdb/v1.7/tools/api.md @@ -8,6 +8,7 @@ menu: name: InfluxDB API reference weight: 20 parent: Tools +v2: /influxdb/v2.0/reference/api/ --- The InfluxDB API provides a simple way to interact with the database. diff --git a/content/influxdb/v1.7/tools/api_client_libraries.md b/content/influxdb/v1.7/tools/api_client_libraries.md index be4ccb87e..509dc0613 100644 --- a/content/influxdb/v1.7/tools/api_client_libraries.md +++ b/content/influxdb/v1.7/tools/api_client_libraries.md @@ -9,6 +9,7 @@ menu: influxdb_1_7: weight: 30 parent: Tools +v2: /influxdb/v2.0/tools/client-libraries/ --- InfluxDB client libraries are developed by the open source community. These client libraries support the InfluxDB 1.7 API and should be fully compatible with InfluxDB 1.5+. Functionality will vary as there are no standard features that all libraries must implement in order to be listed here. diff --git a/content/influxdb/v1.7/tools/grafana.md b/content/influxdb/v1.7/tools/grafana.md index 0a3eb33c5..12cae5f58 100644 --- a/content/influxdb/v1.7/tools/grafana.md +++ b/content/influxdb/v1.7/tools/grafana.md @@ -6,6 +6,7 @@ menu: url: "https://grafana.com/docs/grafana/latest/features/datasources/influxdb/" weight: 60 parent: Tools +v2: /influxdb/v2.0/tools/grafana/ --- Please see [Grafana's InfluxDB documentation](https://grafana.com/docs/grafana/latest/features/datasources/influxdb/). diff --git a/content/influxdb/v1.7/tools/influx-cli/_index.md b/content/influxdb/v1.7/tools/influx-cli/_index.md index 407d4f93e..9d1f8c5ad 100644 --- a/content/influxdb/v1.7/tools/influx-cli/_index.md +++ b/content/influxdb/v1.7/tools/influx-cli/_index.md @@ -5,6 +5,7 @@ menu: name: influx weight: 10 parent: Tools +v2: /influxdb/v2.0/reference/cli/influx/ --- The `influx` command line interface (CLI) includes commands to manage many aspects of InfluxDB, including databases, organizations, users, and tasks. diff --git a/content/influxdb/v1.7/tools/influx_inspect.md b/content/influxdb/v1.7/tools/influx_inspect.md index 29a375de1..f055c680f 100644 --- a/content/influxdb/v1.7/tools/influx_inspect.md +++ b/content/influxdb/v1.7/tools/influx_inspect.md @@ -5,6 +5,7 @@ menu: influxdb_1_7: weight: 50 parent: Tools +v2: /influxdb/v2.0/reference/cli/influxd/inspect/ --- Influx Inspect is an InfluxDB disk utility that can be used to: diff --git a/content/influxdb/v1.7/tools/influxd-cli/_index.md b/content/influxdb/v1.7/tools/influxd-cli/_index.md index 4244472be..159633f53 100644 --- a/content/influxdb/v1.7/tools/influxd-cli/_index.md +++ b/content/influxdb/v1.7/tools/influxd-cli/_index.md @@ -6,6 +6,7 @@ menu: name: influxd weight: 10 parent: Tools +v2: /influxdb/v2.0/reference/cli/influxd/ --- The `influxd` command line interface (CLI) starts and runs all the processes necessary for InfluxDB to function. diff --git a/content/influxdb/v1.7/tools/influxd-cli/backup.md b/content/influxdb/v1.7/tools/influxd-cli/backup.md index 4941d0196..bde299fd8 100644 --- a/content/influxdb/v1.7/tools/influxd-cli/backup.md +++ b/content/influxdb/v1.7/tools/influxd-cli/backup.md @@ -6,6 +6,7 @@ menu: name: influxd backup weight: 10 parent: influxd +v2: /influxdb/v2.0/reference/cli/influx/backup/ --- The `influxd backup` command crates a backup copy of specified InfluxDB OSS database(s) and saves the files in an Enterprise-compatible format to PATH (directory where backups are saved). diff --git a/content/influxdb/v1.7/tools/influxd-cli/restore.md b/content/influxdb/v1.7/tools/influxd-cli/restore.md index e122d95aa..81be8792f 100644 --- a/content/influxdb/v1.7/tools/influxd-cli/restore.md +++ b/content/influxdb/v1.7/tools/influxd-cli/restore.md @@ -6,6 +6,7 @@ menu: name: influxd restore weight: 10 parent: influxd +v2: /influxdb/v2.0/reference/cli/influxd/restore/ --- The `influxd restore` command restores backup data and metadata from an InfluxDB backup directory. diff --git a/content/influxdb/v1.7/tools/influxd-cli/run.md b/content/influxdb/v1.7/tools/influxd-cli/run.md index 763711135..ff80ed747 100644 --- a/content/influxdb/v1.7/tools/influxd-cli/run.md +++ b/content/influxdb/v1.7/tools/influxd-cli/run.md @@ -6,6 +6,7 @@ menu: name: influxd run weight: 10 parent: influxd +v2: /influxdb/v2.0/reference/cli/influxd/run/ --- The `influxd run` command is the default command for `influxd`. diff --git a/content/influxdb/v1.7/tools/influxd-cli/version.md b/content/influxdb/v1.7/tools/influxd-cli/version.md index a731c6fda..dd8995d0a 100644 --- a/content/influxdb/v1.7/tools/influxd-cli/version.md +++ b/content/influxdb/v1.7/tools/influxd-cli/version.md @@ -6,6 +6,7 @@ menu: name: influxd version weight: 10 parent: influxd +v2: /influxdb/v2.0/reference/cli/influxd/version/ --- diff --git a/content/influxdb/v1.7/write_protocols/_index.md b/content/influxdb/v1.7/write_protocols/_index.md index 7a7a9517e..72a3f8201 100644 --- a/content/influxdb/v1.7/write_protocols/_index.md +++ b/content/influxdb/v1.7/write_protocols/_index.md @@ -5,6 +5,7 @@ menu: influxdb_1_7: name: Write protocols weight: 80 +v2: /influxdb/v2.0/reference/syntax/line-protocol/ --- The InfluxDB line protocol is a text based format for writing points to InfluxDB databases. diff --git a/content/influxdb/v1.7/write_protocols/line_protocol_reference.md b/content/influxdb/v1.7/write_protocols/line_protocol_reference.md index 8c835d475..ff690ae88 100644 --- a/content/influxdb/v1.7/write_protocols/line_protocol_reference.md +++ b/content/influxdb/v1.7/write_protocols/line_protocol_reference.md @@ -8,6 +8,7 @@ menu: weight: 10 parent: Write protocols canonical: /{{< latest "influxdb" "v2" >}}/reference/syntax/line-protocol/ +v2: /influxdb/v2.0/reference/syntax/line-protocol/ --- InfluxDB line protocol is a text based format for writing points to InfluxDB. diff --git a/content/influxdb/v1.7/write_protocols/line_protocol_tutorial.md b/content/influxdb/v1.7/write_protocols/line_protocol_tutorial.md index 65d65c2f2..9646d95dc 100644 --- a/content/influxdb/v1.7/write_protocols/line_protocol_tutorial.md +++ b/content/influxdb/v1.7/write_protocols/line_protocol_tutorial.md @@ -6,6 +6,7 @@ menu: influxdb_1_7: weight: 20 parent: Write protocols +v2: /influxdb/v2.0/reference/syntax/line-protocol/ --- The InfluxDB line protocol is a text based format for writing points to the diff --git a/content/influxdb/v1.8/guides/hardware_sizing.md b/content/influxdb/v1.8/guides/hardware_sizing.md index a4c01f4ba..5d24cc67e 100644 --- a/content/influxdb/v1.8/guides/hardware_sizing.md +++ b/content/influxdb/v1.8/guides/hardware_sizing.md @@ -115,9 +115,6 @@ Guidelines vary by writes per second per node, moderate queries per second per n In general, more RAM helps queries return faster. Your RAM requirements are primarily determined by [series cardinality](/influxdb/v1.8/concepts/glossary/#series-cardinality). Higher cardinality requires more RAM. Regardless of RAM, a series cardinality of 10 million or more can cause OOM (out of memory) failures. You can usually resolve OOM issues by redesigning your [schema](/influxdb/v1.8/concepts/glossary/#schema). -The increase in RAM needs relative to series cardinality is exponential where the exponent is between one and two: - - ## Guidelines per cluster diff --git a/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/_index.md b/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/_index.md new file mode 100644 index 000000000..821b7cb57 --- /dev/null +++ b/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/_index.md @@ -0,0 +1,32 @@ +--- +title: Flux Opsgenie package +list_title: Opsgenie package +description: > + The Flux Opsgenie package provides functions that send alerts to + [Atlassian Opsgenie](https://www.atlassian.com/software/opsgenie) using the + [Opsgenie v2 API](https://docs.opsgenie.com/docs/alert-api#create-alert). + Import the `contrib/sranka/opsgenie` package. +menu: + influxdb_2_0_ref: + name: Opsgenie + parent: Contributed +weight: 202 +influxdb/v2.0/tags: [functions, opsgenie, package] +--- + +The Flux Opsgenie package provides functions that send alerts to +[Atlassian Opsgenie](https://www.atlassian.com/software/opsgenie) using the +[Opsgenie v2 API](https://docs.opsgenie.com/docs/alert-api#create-alert). +Import the `contrib/sranka/opsgenie` package: + +```js +import "contrib/sranka/opsgenie" +``` + +{{< children type="functions" show="pages" >}} + +{{% note %}} +#### Package author and maintainer +**Github:** [@sranka](https://github.com/sranka) +**InfluxDB Slack:** [@sranka](https://influxdata.com/slack) +{{% /note %}} diff --git a/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/endpoint.md b/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/endpoint.md new file mode 100644 index 000000000..93f1ad852 --- /dev/null +++ b/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/endpoint.md @@ -0,0 +1,104 @@ +--- +title: opsgenie.endpoint() function +description: > + The `opsgenie.endpoint()` function sends an alert message to Opsgenie using data from table rows. +menu: + influxdb_2_0_ref: + name: opsgenie.endpoint + parent: Opsgenie +weight: 202 +--- + +The `opsgenie.endpoint()` function sends an alert message to Opsgenie using data from table rows. + +_**Function type:** Output_ + +```js +import "contrib/sranka/opsgenie" + +opsgenie.endpoint( + url: "https://api.opsgenie.com/v2/alerts", + apiKey: "YoUrSup3R5ecR37AuThK3y", + entity: "example-entity" +) +``` + +## Parameters + +### url +Opsgenie API URL. +Defaults to `https://api.opsgenie.com/v2/alerts`. + +_**Data type:** String_ + +### apiKey +Required +Opsgenie API authorization key. + +_**Data type:** String_ + +### entity +Alert entity used to specify the alert domain. + +_**Data type:** String_ + +## Usage +`opsgenie.endpoint` is a factory function that outputs another function. +The output function requires a `mapFn` parameter. + +### mapFn +A function that builds the record used to generate the POST request. +Requires an `r` parameter. + +_**Data type:** Function_ + +`mapFn` accepts a table row (`r`) and returns a record that must include the +following fields: + +- `message` +- `alias` +- `description` +- `priority` +- `responders` +- `tags` +- `actions` +- `details` +- `visibleTo` + +_For more information, see [`opsgenie.sendAlert()`](/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/sendalert/)._ + +## Examples + +##### Send critical statuses to Opsgenie +```js +import "influxdata/influxdb/secrets" +import "contrib/sranka/opsgenie" + +apiKey = secrets.get(key: "OPSGENIE_APIKEY") +endpoint = opsgenie.endpoint(apiKey: apiKey) + +crit_statuses = from(bucket: "example-bucket") + |> range(start: -1m) + |> filter(fn: (r) => r._measurement == "statuses" and status == "crit") + +crit_statuses + |> endpoint(mapFn: (r) => ({ + message: "Great Scott!- Disk usage is: ${r.status}.", + alias: "disk-usage-${r.status}", + description: "", + priority: "P3", + responders: ["user:john@example.com", "team:itcrowd"], + tags: [], + entity: "my-lab", + actions: [], + details: "{}", + visibleTo: [] + }) + )() +``` + +{{% note %}} +#### Package author and maintainer +**Github:** [@sranka](https://github.com/sranka) +**InfluxDB Slack:** [@sranka](https://influxdata.com/slack) +{{% /note %}} diff --git a/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/sendalert.md b/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/sendalert.md new file mode 100644 index 000000000..2c0a218b5 --- /dev/null +++ b/content/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/sendalert.md @@ -0,0 +1,142 @@ +--- +title: opsgenie.sendAlert() function +description: > + The `opsgenie.sendAlert()` function sends an alert message to Opsgenie. +menu: + influxdb_2_0_ref: + name: opsgenie.sendAlert + parent: Opsgenie +weight: 202 +--- + +The `opsgenie.sendAlert()` function sends an alert message to Opsgenie. + +_**Function type:** Output_ + +```js +import "contrib/sranka/opsgenie" + +opsgenie.sendAlert( + url: "https://api.opsgenie.com/v2/alerts", + apiKey: "YoUrSup3R5ecR37AuThK3y", + message: "Example message", + alias: "Example alias", + description: "Example description", + priority: "P3", + responders: ["user:john@example.com", "team:itcrowd"], + tags: ["tag1", "tag2"], + entity: "example-entity", + actions: ["action1", "action2"], + details: "{}", + visibleTo: [] +) +``` + +## Parameters + +### url +Opsgenie API URL. +Defaults to `https://api.opsgenie.com/v2/alerts`. + +_**Data type:** String_ + +### apiKey +Required +Opsgenie API authorization key. + +_**Data type:** String_ + +### message +Required +Alert message text. +130 characters or less. + +_**Data type:** String_ + +### alias +Opsgenie alias usee to de-deduplicate alerts. +250 characters or less. +Defaults to [message](#message). + +_**Data type:** String_ + +### description +Alert description. +15000 characters or less. + +_**Data type:** String_ + +### priority +Opsgenie [alert priority](https://docs.opsgenie.com/docs/alert-priority-settings). +Valid values include: + +- `P1` +- `P2` +- `P3` _(default)_ +- `P4` +- `P5` + +_**Data type:** String_ + +### responders +List of responder teams or users. +Use the `user:` prefix for users and `teams:` prefix for teams. + +_**Data type:** Array of strings_ + +### tags +Alert tags. + +_**Data type:** Array of strings_ + +### entity +Alert entity used to specify the alert domain. + +_**Data type:** String_ + +### actions +List of actions available for the alert. + +_**Data type:** Array of strings_ + +### details +Additional alert details. +Must be a JSON-encoded map of key-value string pairs. + +_**Data type:** String_ + +### visibleTo +List of teams and users the alert will be visible to without sending notifications. +Use the `user:` prefix for users and `teams:` prefix for teams. + +_**Data type:** Array of strings_ + +## Examples + +##### Send the last reported status to a Opsgenie +```js +import "influxdata/influxdb/secrets" +import "contrib/sranka/opsgenie" + +apiKey = secrets.get(key: "OPSGENIE_APIKEY") + +lastReported = + from(bucket: "example-bucket") + |> range(start: -1m) + |> filter(fn: (r) => r._measurement == "statuses") + |> last() + |> findRecord(fn: (key) => true, idx: 0) + + opsgenie.sendAlert( + apiKey: apiKey, + message: "Disk usage is: ${lastReported.status}.", + alias: "example-disk-usage", + responders: ["user:john@example.com", "team:itcrowd"] + ) +``` + +{{% note %}} +#### Package author and maintainer +**Github:** [@sranka](https://github.com/sranka) +**InfluxDB Slack:** [@sranka](https://influxdata.com/slack) +{{% /note %}} diff --git a/content/influxdb/v2.0/reference/release-notes/flux.md b/content/influxdb/v2.0/reference/release-notes/flux.md index bc4e16efc..be61f1037 100644 --- a/content/influxdb/v2.0/reference/release-notes/flux.md +++ b/content/influxdb/v2.0/reference/release-notes/flux.md @@ -14,6 +14,22 @@ Though newer versions of Flux may be available, they will not be included with InfluxDB until the next InfluxDB v2.0 release._ {{% /note %}} +## v0.84.0 [2020-09-09] + +### Breaking changes +- Remove time-column parameters from `range()` function and update type signature. + +### Features +- Add [Opsgenie package](/influxdb/v2.0/reference/flux/stdlib/contrib/opsgenie/). +- Implement [`lastSuccess()`](/influxdb/v2.0/reference/flux/stdlib/influxdb-tasks/lastsuccess/) in the `tasks` package. +- Support duration values in `aggregateWindow`. +- Update Apache Arrow to 1.0.1. + +### Bug fixes +- Ensure meta columns are never part of group key. + +--- + ## v0.83.1 [2020-09-02] ### Bug fixes diff --git a/content/influxdb/v2.0/reference/release-notes/influxdb-cloud.md b/content/influxdb/v2.0/reference/release-notes/influxdb-cloud.md index 56beefada..4ceba0f17 100644 --- a/content/influxdb/v2.0/reference/release-notes/influxdb-cloud.md +++ b/content/influxdb/v2.0/reference/release-notes/influxdb-cloud.md @@ -1,6 +1,6 @@ --- title: InfluxDB Cloud release notes -description: Important changes and and what's new in each InfluxDB Cloud 2.0 update. +description: Important changes and what's new in each InfluxDB Cloud 2.0 update. weight: 101 menu: influxdb_2_0_ref: diff --git a/content/influxdb/v2.0/tools/client-libraries/_index.md b/content/influxdb/v2.0/tools/client-libraries/_index.md index c78861937..938b7273a 100644 --- a/content/influxdb/v2.0/tools/client-libraries/_index.md +++ b/content/influxdb/v2.0/tools/client-libraries/_index.md @@ -6,13 +6,12 @@ description: > weight: 101 aliases: - /influxdb/v2.0/reference/client-libraries/ + - /influxdb/v2.0/reference/api/client-libraries/ menu: influxdb_2_0: name: Use client libraries parent: Tools & integrations influxdb/v2.0/tags: [client libraries] -aliases: - - /influxdb/v2.0/reference/api/client-libraries/ --- InfluxDB client libraries are language-specific packages that integrate with the InfluxDB v2 API. diff --git a/content/influxdb/v2.0/tools/grafana.md b/content/influxdb/v2.0/tools/grafana.md index 0df57b40c..3597665ef 100644 --- a/content/influxdb/v2.0/tools/grafana.md +++ b/content/influxdb/v2.0/tools/grafana.md @@ -50,10 +50,10 @@ configure your InfluxDB connection: 1. Under **Connection**, enter the following: - - **URL**: Your [InfluxDB URL](/influxdb/v2.0/reference/urls/) **with the `/api/v2` path**. + - **URL**: Your [InfluxDB URL](/influxdb/v2.0/reference/urls/). ```sh - http://localhost:9999/api/v2 + http://localhost:9999/ ``` - **Organization**: Your InfluxDB [organization name **or** ID](/influxdb/v2.0/organizations/view-orgs/). diff --git a/content/influxdb/v2.0/write-data/_index.md b/content/influxdb/v2.0/write-data/_index.md index 2c5dd50ad..304aa7558 100644 --- a/content/influxdb/v2.0/write-data/_index.md +++ b/content/influxdb/v2.0/write-data/_index.md @@ -19,14 +19,17 @@ related: - /influxdb/v2.0/reference/cli/influx/write --- -Collect and write time series data to InfluxDB Cloud and InfluxDB OSS. Discover how to quickly start collecting data, and then explore other ways to write data using no-code solutions or developer tools. - +Discover what you'll need to write data into InfluxDB Cloud or OSS (open source). Learn how to quickly start collecting data, and then explore ways to write data, best practices, and what we recommend if you're migrating a large amount of historical data. - [What you'll need](#what-you-ll-need) - [Quickly start collecting data](#quickly-start-collecting-data) - [Demo data for InfluxDB Cloud](#demo-data-for-influxdb-cloud) - [Quick Start for InfluxDB OSS](#quick-start-for-influxdb-oss) -- [Other ways to write data](#other-ways-to-write-data) +- [Load data from sources in the InfluxDB UI](/influxdb/v2.0/write-data/load-data/) +- [Use no-code solutions](/influxdb/v2.0/write-data/no-code) +- [Use developer tools](/influxdb/v2.0/write-data/developer-tools) +- [Best practices for writing data](/influxdb/v2.0/write-data/best-practices/) +- [Migrate historical data](/influxdb/v2.0/write-data/bulk-ingest-cloud/) - [Next steps](#next-steps) ### What you'll need @@ -163,16 +166,6 @@ If you missed the Quick Start option, you can [manually create a scraper](/influ that scrapes data from the `/metrics` endpoint. {{% /note %}} - ---- - -## Other ways to write data - -There are multiple options for writing data into InfluxDB, including both no-code and developer solutions. - - - [No-code solutions](/influxdb/v2.0/write-data/no-code) - - [Developer tools](/influxdb/v2.0/write-data/developer-tools) - --- ## Next steps diff --git a/content/influxdb/v2.0/write-data/load-data.md b/content/influxdb/v2.0/write-data/load-data.md new file mode 100644 index 000000000..353ec79e3 --- /dev/null +++ b/content/influxdb/v2.0/write-data/load-data.md @@ -0,0 +1,45 @@ +--- +title: Load data from sources in the InfluxDB user interface (UI) +seotitle: Load data source in UI +list_title: Load data source in UI +weight: 105 +description: > + Load data from sources in the InfluxDB user interface (UI). Choose from popular client libraries (such as Python, Ruby, Scala, and more!) or load data with a Telegraf plugin (like MQTT Consumer, MySQL, File, and many more!). +menu: + influxdb_2_0: + name: Load data source in UI + parent: Write data +--- + +Load data from the following sources in the InfluxDB user interface (UI): + +- [Client libraries](#load-data-from-a-client-library-in-the-ui) +- [Telegraf plugins](#load-data-from-a-telegraf-plugin-in-the-ui) + +### Load data from a client library in the UI + +1. In the navigation menu on the left, click **Data (Load Data)** > **Sources**. + {{< nav-icon "data" >}} +2. Do one of the following: + - Enter a specific client library to search for in the **Search data writing methods** field. + - Scroll down to browse available client libraries. +3. Click the client library to load data from. +4. Under **Code Sample Options**, you'll see a list of your InfluxDB [tokens](/influxdb/v2.0/reference/glossary/#token) and [buckets](/influxdb/v2.0/reference/glossary/#bucket). Select both an authentication token and a bucket to write your data to. The selected token and bucket are automatically added to scripts on the page that you can use to initialize a client and write data. +5. Click the **Copy to Clipboard** buttons under a script to easily paste the script into your terminal or save the script to reuse for automation. +6. Run the scripts on the page to do the following as needed: + - Install the package, libraries, or client + - Write data + - Execute a Flux query + +### Load data from a Telegraf plugin in the UI + +1. In the navigation menu on the left, click **Data (Load Data)** > **Sources**. + {{< nav-icon "data" >}} +2. Do one of the following: + - Enter a specific Telegraf plugin to search for in the **Search data writing methods** field. + - Scroll down to browse available plugins. +3. Click the plugin to load data from. +4. [Install Telegraf](/telegraf/v1.15/introduction/installation/). +5. Copy the default configuration script in the UI, and then add the script to [Configure Telegraf](/telegraf/v1.15/introduction/getting-started/#configure-telegraf). +6. Adjust configuration settings as needed. To find configuration settings for a specific plugin, see [Telegraf plugins](/telegraf/v1.15/plugins/). +7. (Optional) To add the Telegraf configuration to InfluxDB, see [Telegraf configuration](/influxdb/v2.0/telegraf-configs/). diff --git a/content/platform/install-and-deploy/deploying/kubernetes.md b/content/platform/install-and-deploy/deploying/kubernetes.md index 9e29bf46d..371c8888d 100644 --- a/content/platform/install-and-deploy/deploying/kubernetes.md +++ b/content/platform/install-and-deploy/deploying/kubernetes.md @@ -10,18 +10,16 @@ menu: weight: 4 --- -## Deploy the TICK stack in Kubernetes - -Instructions for installing and configuring all components of the open source TICK stack – Telegraf, InfluxDB, Chronograf, and Kapacitor in Kubernetes. +Install and configure the TICK stack—Telegraf, InfluxDB, Chronograf, and Kapacitor—in Kubernetes. ### Use Helm Charts to deploy InfluxData Platform components -InfluxData recommends using the [Helm Stable](https://github.com/helm/charts/tree/master/stable) repository for installing the TICK stack. +InfluxData recommends using the [Helm Stable](https://github.com/helm/charts/tree/master/stable) repository to install the TICK stack: -- [Telegraf](https://github.com/helm/charts/tree/master/stable/telegraf) -- [InfluxDB](https://github.com/helm/charts/tree/master/stable/influxdb) -- [Chronograf](https://github.com/helm/charts/tree/master/stable/chronograf) -- [Kapacitor](https://github.com/helm/charts/tree/master/stable/kapacitor) +- [Telegraf](https://github.com/influxdata/helm-charts/tree/master/charts/telegraf) +- [InfluxDB](https://github.com/influxdata/helm-charts/tree/master/charts/influxdb) +- [Chronograf](https://github.com/influxdata/helm-charts/tree/master/charts/chronograf) +- [Kapacitor](https://github.com/influxdata/helm-charts/tree/master/charts/kapacitor) ### Use the InfluxDB Operator diff --git a/deploy/edge.js b/deploy/edge.js index e5db88044..179f98ba2 100644 --- a/deploy/edge.js +++ b/deploy/edge.js @@ -71,6 +71,10 @@ exports.handler = (event, context, callback) => { '.ttf': true, '.woff': true, '.otf': true, + '.gz': true, + '.tar': true, + '.md5': true, + '.sha256': true, }; // Remove index.html from path diff --git a/layouts/partials/article/feedback.html b/layouts/partials/article/feedback.html index 6d59a0ddc..6935d5461 100644 --- a/layouts/partials/article/feedback.html +++ b/layouts/partials/article/feedback.html @@ -8,7 +8,11 @@ {{ $productName := (index .Site.Data.products $product).name }} {{ $supportBlacklist := slice "chronograf" "kapacitor" }} -{{ .Scratch.Set "pageGithubLink" (print "https://github.com/influxdata/docs-v2/edit/master/content/" .File.Path) }} +{{ if .File }} + {{ .Scratch.Set "pageGithubLink" (print "https://github.com/influxdata/docs-v2/edit/master/content/" .File.Path) }} +{{ else }} + {{ .Scratch.Set "pageGithubLink" (print "https://github.com/influxdata/docs-v2/edit/master/content/") }} +{{ end }} {{ .Scratch.Set "productGithubLink" (print "https://github.com/influxdata/" $product "/issues/new/choose/") }} {{ $pageGithubLink := .Scratch.Get "pageGithubLink" }} {{ $productGithubLink := .Scratch.Get "productGithubLink" }} diff --git a/layouts/partials/article/flux-contrib.html b/layouts/partials/article/flux-contrib.html index 8c6dc0676..257b27282 100644 --- a/layouts/partials/article/flux-contrib.html +++ b/layouts/partials/article/flux-contrib.html @@ -1,4 +1,4 @@ -{{ $currentVersion := (index (findRE "[^/]+.*?" .RelPermalink) 1) .RelPermalink }} +{{ $currentVersion := index (findRE "[^/]+.*?" .RelPermalink) 1 }} {{ $contribPath := print "/influxdb/" $currentVersion "/reference/flux/stdlib/contrib/" }} {{ if in .RelPermalink $contribPath }} diff --git a/layouts/partials/article/flux-experimental.html b/layouts/partials/article/flux-experimental.html index c7d4d2de5..44b3ee681 100644 --- a/layouts/partials/article/flux-experimental.html +++ b/layouts/partials/article/flux-experimental.html @@ -1,4 +1,4 @@ -{{ $currentVersion := (index (findRE "[^/]+.*?" .RelPermalink) 1) .RelPermalink }} +{{ $currentVersion := index (findRE "[^/]+.*?" .RelPermalink) 1 }} {{ $expRiskURL := print "/influxdb/" $currentVersion "/reference/flux/stdlib/experimental/#use-experimental-functions-at-your-own-risk" }} {{ $expPath := print "/influxdb/" $currentVersion "/reference/flux/stdlib/experimental/" }} diff --git a/layouts/partials/footer/influxdb-url-modal.html b/layouts/partials/footer/influxdb-url-modal.html index e66466b5c..07551b6ad 100644 --- a/layouts/partials/footer/influxdb-url-modal.html +++ b/layouts/partials/footer/influxdb-url-modal.html @@ -1,4 +1,4 @@ -{{ $currentVersion := (index (findRE "[^/]+.*?" .RelPermalink) 0) .RelPermalink | default "v2.0" }} +{{ $currentVersion := index (findRE "[^/]+.*?" .RelPermalink) 0 | default "v2.0" }}