1.. _1-1-3: 2 31.1.3 4=========================== 5*04/04/2018* 6 7Graphite 1.1.3 is now available for usage. Please note that this is a bugfix release for stable Graphite 1.1.x branch and it's recommended for production usage. It also contains some improvements backported from master branch. 8 9Source bundles are available from GitHub: 10 11* https://github.com/graphite-project/graphite-web/archive/1.1.3.tar.gz 12* https://github.com/graphite-project/carbon/archive/1.1.3.tar.gz 13* https://github.com/graphite-project/whisper/archive/1.1.3.tar.gz 14* https://github.com/graphite-project/carbonate/archive/1.1.3.tar.gz 15 16Graphite can also be installed from `PyPI <http://pypi.python.org/>`_ via 17`pip <http://www.pip-installer.org/en/latest/index.html>`_. PyPI bundles are here: 18 19* http://pypi.python.org/pypi/graphite-web/ 20* http://pypi.python.org/pypi/carbon/ 21* http://pypi.python.org/pypi/whisper/ 22* http://pypi.python.org/pypi/carbonate/ 23 24Upgrading 25--------- 26Please upgrade carbon and graphite-web - they contain valuable bugfixes and improvements. Whisper package was not changed. If you using carbonate it also should be upgraded. 27 28Please also note that previous versions of graphite-web and carbon packages under some circumstances can delete your whisper directories during `pip uninstall`. It's fixed in 1.1.3, but before upgrade please remove all `/opt/graphite/storage` entries from pip installation files (usually located in `/opt/graphite/lib/carbon-X.X.X-pyY.Y.egg-info/installed-files.txt` and `/opt/graphite/lib/graphite-web-X.X.X-pyY.Y.egg-info/installed-files.txt`, where `X.X.X` is Graphite version and `Y.Y` is Python version) 29 30Incompatible changes 31-------------------- 32 33This version of carbon adds support for naming tagged metric filenames using only the hash of the metric name, which avoids issues with filename length limits when multiple tags are used. 34 35The hashed naming scheme is now the default, to return to the old scheme the user can add TAG_HASH_FILENAMES = False to their config. Graphite-web will look for both variants so there isn't a need for a configuration option in graphite-web. 36 37 38Security Notes 39-------------- 40None 41 42 43New features 44------------ 45 46Graphite-Web 47^^^^^^^^^^^^ 48 49* add optional keepStep parameter to aggregateLine (@DanCech, #2234) 50 51* Support for storing tagged series in hashed filenames (@DanCech, #2221) 52 53* support specifying noNullPoints and maxDataPoints together (@DanCech, #2257) 54 55* Support negative steps in `delay` render function (@dimrozakis, #2262) 56 57Carbon 58^^^^^^ 59 60* Support for storing tagged series in hashed filenames (@DanCech, #743) 61 62 63Whisper 64^^^^^^^ 65 66* None 67 68Carbonate 69^^^^^^^^^ 70 71* Adding LICENSE file to pypi package (@deniszh, #97) 72 73Bug Fixes 74--------- 75 76Graphite-Web 77^^^^^^^^^^^^ 78 79* w/g/f/remote.py: add missing local field to auto_complete_{tags,values} (@Quentin-M, #2244) 80 81* fix hitcount bucket calculation (@DanCech, #2252) 82 83* fix usage of "unicode" in glyph.py for Python 3 (@JelleZijlstra , #2254) 84 85* Adding dummy.txt to storage dirs (@deniszh, #2259) 86 87* missing static location for nginx-uwsgi in documentation (@bitfur, #2260) 88 89* graphite functions: handle max on empty sequences better (@JelleZijlstra, #2266) 90 91 92Carbon 93^^^^^^ 94 95* Adding dummy.txt to storage dirs (@deniszh, #753) 96 97 98Whisper 99^^^^^^^ 100 101* None 102 103 104Carbonate 105^^^^^^^^^ 106 107* Fixing carbon router hash (@deniszh, #93) 108