oslo.metrics 0.4.0 release

meta:version: 0.4.0
meta:diff-start: -
meta:series: yoga
meta:release-type: release
meta:pypi: yes
meta:first: yes
meta:release:Author: Hervé Beraud <hberaud@redhat.com>
meta:release:Commit: Hervé Beraud <hberaud@redhat.com>
meta:release:Change-Id: Ic6d479ec8720cdf5fcdb958dde3b66669bf7a2e0
meta:release:Code-Review+2: Elod Illes <elod.illes@est.tech>
meta:release:Code-Review+2: Thierry Carrez <thierry@openstack.org>
meta:release:Workflow+1: Thierry Carrez <thierry@openstack.org>

This limits the metrics_socket_file permissions to 0o660. Prior
to this change, symbolic constants were used, resulting in
0o707 permissions.

Closes-Bug: #1945533
Change-Id: I009ffbc10d3400881c6f8b2178494ba180d6549f

  * Added (c) 2020 LINE Corp. in d/copyright after FTP master remark.

Add file to the reno documentation build to show release notes for
stable/xena.

Use pbr instruction to increment the minor version number
automatically so that master versions are higher than the versions on
stable/xena.

Sem-Ver: feature
Change-Id: I2140ba315f0cd83f89fe2b3d7529a5b016b3ce03

The patch bumps min version of tox to 3.18.0 in order to
replace tox's whitelist_externals by allowlist_externals option:
https://github.com/tox-dev/tox/blob/master/docs/changelog.rst#v3180-2020-07-23

Change-Id: I382ca56a7f04aba92fbff060e28df6814712a153

Setuptools v54.1.0 introduces a warning that the use of
dash-separated options in 'setup.cfg' will not be supported
in a future version [1].
Get ahead of the issue by replacing the dashes with underscores.
Without this, we see 'UserWarning' messages
like the following on new enough
versions of setuptools:

  UserWarning: Usage of dash-separated 'description-file' will not be
      supported in future versions. Please use the underscore name
            'description_file' instead

	          [1]
		  https://github.com/pypa/setuptools/commit/a2e9ae4cb

Change-Id: I39365ad5511672d8fb5803ef09afe47fa867a5d2

This commit enables code coverage and added unit tests for metrics
message verification.

Change-Id: I526c8ce8583f0df6cb0323e5ce6bc98ecf310f4f

Change-Id: I270734c7cbd017e5476fbc4eb94f1b81708ae200

This commit enables bandit check and update the version to larger than
1.6.0 to prevent some issue.

Change-Id: I8da25bbb00ea2a6793b62924eb59c468b7384668

This commit added an integer configuration prometheus_port. This allow
user to specify the port number to expose metrics information in
prometheus format.

Change-Id: I7ee36dc219be9c997647590e847844bfd74bc129

This commit added a guide to test out oslo.metrics using Devstack.

Change-Id: I2e9c8eb5da687684df3dcd897ce1f90a18a11dbf

Moving on py3 as the default runtime for tox to avoid to update this at
each new cycle.

Change-Id: Ibd1226b0e72ec374d36a90a826b8cc6c6b57d1f2

We facing errors related to the new pip resolver, this
topic was discussed on the ML and QA team proposed to
to test lower-constraints [1].

I propose to drop this test because the complexity and recurring pain needed
to maintain that now exceeds the benefits provided by this mechanismes.

[1] http://lists.openstack.org/pipermail/openstack-discuss/2020-December/019390.html

Change-Id: Ibd446707bbdb46f4c3fe5b4f8d7dd754d79c2db0

Add file to the reno documentation build to show release notes for
stable/wallaby.

Use pbr instruction to increment the minor version number
automatically so that master versions are higher than the versions on
stable/wallaby.

Sem-Ver: feature
Change-Id: I721bcefb66864d2c281f0e936b13531403aa0959

We are missing timeout and method in label definition for rpc client
this will cause message router to failed to parse messages as there are
unexpected labels sent from oslo.messaging.

This commit added timeout and method to rpc client labels to fix the
issue.

Change-Id: I9ed133543ae6846256c1ea81602ca864f3847dec

This commit updates metric naming and description based on the best
practice[1] provided by prometheus.

[1] https://prometheus.io/docs/practices/naming/

Change-Id: Icfbef102d8fb0498ae93fa925937acaa338850c2

Currently oslo.metrics http server doesn't handle sigterm signal. This
commit added support to handle sigterm and shutdown gracefully.

Change-Id: I3a5b1a5ebcadfd0c64fcbea0216503dd7f984411

This commit includes 2 improvements for oslo.metrics UDP socket

- When starting oslo.metrics unlink the socket first before binding
- Change the mode for file so that other OpenStack process running in
  other user can access and send metrics e.g. nova, neutron

Change-Id: I27672f03d282acf1e9cb669998899a032fe4202a

in 'victoria' cycle, we should test py38 by default.

ref:
  https://governance.openstack.org/tc/reference/runtimes/victoria.html

Change-Id: I183db1a6db8ff512a20a3a467770f9b6f1cbd260

Add tests checking that a JSON message will be correctly mapped to
their configured Prometheus client action.

This replaces the noop test that was just a noop.

Change-Id: I7362ad86fdc5dcb0a83b5173c3f20611577d0692

Add a noop test as a basic test framework.
Properly comment out the bandit line to not give the impression that
it's actually tested (it was misconfigured before).

Change-Id: Ic2278816d50ec0fa628f6616839f8b9dc0a5c299

Change-Id: I27ff259c91bb90e148e2131fb8c77be4d405648c