OCA-git-bot
3 years ago
19 changed files with 1334 additions and 317 deletions
-
2requirements.txt
-
168sentry/README.rst
-
83sentry/__init__.py
-
7sentry/__manifest__.py
-
103sentry/const.py
-
63sentry/generalutils.py
-
113sentry/hooks.py
-
129sentry/logutils.py
-
137sentry/processor.py
-
3sentry/readme/CONFIGURE.rst
-
4sentry/readme/CONTRIBUTORS.rst
-
1sentry/readme/CREDITS.rst
-
76sentry/readme/DESCRIPTION.rst
-
10sentry/readme/INSTALL.rst
-
11sentry/readme/ROADMAP.rst
-
6sentry/readme/USAGE.rst
-
579sentry/static/description/index.html
-
142sentry/tests/test_client.py
-
14sentry/tests/test_logutils.py
@ -1,82 +1 @@ |
|||
# Copyright 2016-2017 Versada <https://versada.eu/> |
|||
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). |
|||
|
|||
import logging |
|||
|
|||
from odoo.service import wsgi_server |
|||
from odoo.tools import config as odoo_config |
|||
|
|||
from . import const |
|||
from .logutils import LoggerNameFilter, OdooSentryHandler |
|||
|
|||
import collections |
|||
|
|||
_logger = logging.getLogger(__name__) |
|||
HAS_RAVEN = True |
|||
try: |
|||
import raven |
|||
from raven.middleware import Sentry |
|||
except ImportError: |
|||
HAS_RAVEN = False |
|||
_logger.debug('Cannot import "raven". Please make sure it is installed.') |
|||
|
|||
|
|||
def get_odoo_commit(odoo_dir): |
|||
'''Attempts to get Odoo git commit from :param:`odoo_dir`.''' |
|||
if not odoo_dir: |
|||
return |
|||
try: |
|||
return raven.fetch_git_sha(odoo_dir) |
|||
except raven.exceptions.InvalidGitRepository: |
|||
_logger.debug( |
|||
'Odoo directory: "%s" not a valid git repository', odoo_dir) |
|||
|
|||
|
|||
def initialize_raven(config, client_cls=None): |
|||
''' |
|||
Setup an instance of :class:`raven.Client`. |
|||
|
|||
:param config: Sentry configuration |
|||
:param client: class used to instantiate the raven client. |
|||
''' |
|||
enabled = config.get('sentry_enabled', False) |
|||
if not (HAS_RAVEN and enabled): |
|||
return |
|||
|
|||
if config.get('sentry_odoo_dir') and config.get('sentry_release'): |
|||
_logger.debug('Both sentry_odoo_dir and sentry_release defined, choosing sentry_release') |
|||
options = { |
|||
'release': config.get('sentry_release', get_odoo_commit(config.get('sentry_odoo_dir'))), |
|||
} |
|||
for option in const.get_sentry_options(): |
|||
value = config.get('sentry_%s' % option.key, option.default) |
|||
if isinstance(option.converter, collections.Callable): |
|||
value = option.converter(value) |
|||
options[option.key] = value |
|||
|
|||
level = config.get('sentry_logging_level', const.DEFAULT_LOG_LEVEL) |
|||
exclude_loggers = const.split_multiple( |
|||
config.get('sentry_exclude_loggers', const.DEFAULT_EXCLUDE_LOGGERS) |
|||
) |
|||
if level not in const.LOG_LEVEL_MAP: |
|||
level = const.DEFAULT_LOG_LEVEL |
|||
|
|||
client_cls = client_cls or raven.Client |
|||
client = client_cls(**options) |
|||
handler = OdooSentryHandler( |
|||
config.get('sentry_include_context', True), |
|||
client=client, |
|||
level=const.LOG_LEVEL_MAP[level], |
|||
) |
|||
if exclude_loggers: |
|||
handler.addFilter(LoggerNameFilter( |
|||
exclude_loggers, name='sentry.logger.filter')) |
|||
raven.conf.setup_logging(handler) |
|||
wsgi_server.application = Sentry( |
|||
wsgi_server.application, client=client) |
|||
|
|||
client.captureMessage('Starting Odoo Server') |
|||
return client |
|||
|
|||
|
|||
sentry_client = initialize_raven(odoo_config) |
|||
from .hooks import post_load |
@ -0,0 +1,63 @@ |
|||
try: |
|||
from collections.abc import Mapping |
|||
except ImportError: # pragma: no cover |
|||
# Python < 3.3 |
|||
from collections import Mapping # pragma: no cover |
|||
|
|||
|
|||
def string_types(): |
|||
""" Taken from https://git.io/JIv5J """ |
|||
|
|||
return str, |
|||
|
|||
|
|||
def is_namedtuple(value): |
|||
""" https://stackoverflow.com/a/2166841/1843746 |
|||
But modified to handle subclasses of namedtuples. |
|||
Taken from https://git.io/JIsfY |
|||
""" |
|||
if not isinstance(value, tuple): |
|||
return False |
|||
f = getattr(type(value), '_fields', None) |
|||
if not isinstance(f, tuple): |
|||
return False |
|||
return all(type(n) == str for n in f) |
|||
|
|||
|
|||
def iteritems(d, **kw): |
|||
""" Override iteritems for support multiple versions python. |
|||
Taken from https://git.io/JIvMi |
|||
""" |
|||
return iter(d.items(**kw)) |
|||
|
|||
|
|||
def varmap(func, var, context=None, name=None): |
|||
""" Executes ``func(key_name, value)`` on all values |
|||
recurisively discovering dict and list scoped |
|||
values. Taken from https://git.io/JIvMN |
|||
""" |
|||
if context is None: |
|||
context = {} |
|||
objid = id(var) |
|||
if objid in context: |
|||
return func(name, '<...>') |
|||
context[objid] = 1 |
|||
|
|||
if isinstance(var, (list, tuple)) and not is_namedtuple(var): |
|||
ret = [varmap(func, f, context, name) for f in var] |
|||
else: |
|||
ret = func(name, var) |
|||
if isinstance(ret, Mapping): |
|||
ret = dict((k, varmap(func, v, context, k)) |
|||
for k, v in iteritems(var)) |
|||
del context[objid] |
|||
return ret |
|||
|
|||
|
|||
def get_environ(environ): |
|||
""" Returns our whitelisted environment variables. |
|||
Taken from https://git.io/JIsf2 |
|||
""" |
|||
for key in ('REMOTE_ADDR', 'SERVER_NAME', 'SERVER_PORT'): |
|||
if key in environ: |
|||
yield key, environ[key] |
@ -0,0 +1,113 @@ |
|||
# Copyright 2016-2017 Versada <https://versada.eu/> |
|||
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). |
|||
|
|||
import logging |
|||
|
|||
import odoo.http |
|||
from odoo.service import wsgi_server |
|||
from odoo.tools import config as odoo_config |
|||
|
|||
from . import const |
|||
from .logutils import SanitizeOdooCookiesProcessor, fetch_git_sha |
|||
from .logutils import InvalidGitRepository, get_extra_context |
|||
|
|||
import collections |
|||
|
|||
_logger = logging.getLogger(__name__) |
|||
HAS_SENTRY_SDK = True |
|||
try: |
|||
import sentry_sdk |
|||
from sentry_sdk.integrations.wsgi import SentryWsgiMiddleware |
|||
from sentry_sdk.integrations.threading import ThreadingIntegration |
|||
from sentry_sdk.integrations.logging import ignore_logger |
|||
except ImportError: # pragma: no cover |
|||
HAS_SENTRY_SDK = False # pragma: no cover |
|||
_logger.debug("Cannot import 'sentry-sdk'.\ |
|||
Please make sure it is installed.") # pragma: no cover |
|||
|
|||
|
|||
def before_send(event, hint): |
|||
""" Add context to event if include_context is True |
|||
and sanitize sensitive data """ |
|||
if event.setdefault("tags", {})["include_context"]: |
|||
cxtest = get_extra_context(odoo.http.request) |
|||
info_request = ["tags", "user", "extra", "request"] |
|||
|
|||
for item in info_request: |
|||
info_item = event.setdefault(item, {}) |
|||
info_item.update(cxtest.setdefault(item, {})) |
|||
|
|||
raven_processor = SanitizeOdooCookiesProcessor() |
|||
raven_processor.process(event) |
|||
|
|||
return event |
|||
|
|||
|
|||
def get_odoo_commit(odoo_dir): |
|||
"""Attempts to get Odoo git commit from :param:`odoo_dir`.""" |
|||
if not odoo_dir: |
|||
return |
|||
try: |
|||
return fetch_git_sha(odoo_dir) |
|||
except InvalidGitRepository: |
|||
_logger.debug( |
|||
"Odoo directory: '%s' not a valid git repository", odoo_dir) |
|||
|
|||
|
|||
def initialize_sentry(config): |
|||
""" Setup an instance of :class:`sentry_sdk.Client`. |
|||
:param config: Sentry configuration |
|||
:param client: class used to instantiate the sentry_sdk client. |
|||
""" |
|||
enabled = config.get("sentry_enabled", False) |
|||
if not (HAS_SENTRY_SDK and enabled): |
|||
return |
|||
_logger.info("Initializing sentry...") |
|||
if config.get("sentry_odoo_dir") and config.get("sentry_release"): |
|||
_logger.debug("Both sentry_odoo_dir and \ |
|||
sentry_release defined, choosing sentry_release") |
|||
options = { |
|||
"release": config.get("sentry_release", |
|||
get_odoo_commit(config.get("sentry_odoo_dir"))), |
|||
} |
|||
for option in const.get_sentry_options(): |
|||
value = config.get('sentry_%s' % option.key, option.default) |
|||
if isinstance(option.converter, collections.Callable): |
|||
value = option.converter(value) |
|||
options[option.key] = value |
|||
|
|||
exclude_loggers = const.split_multiple( |
|||
config.get("sentry_exclude_loggers", const.DEFAULT_EXCLUDE_LOGGERS) |
|||
) |
|||
# Change name `ignore_exceptions` (with raven) |
|||
# to `ignore_errors' (sentry_sdk) |
|||
options["ignore_errors"] = options["ignore_exceptions"] |
|||
del options["ignore_exceptions"] |
|||
|
|||
options["before_send"] = before_send |
|||
|
|||
options["integrations"] = [options["logging_level"], |
|||
ThreadingIntegration(propagate_hub=True)] |
|||
# Remove logging_level, since in sentry_sdk is include in 'integrations' |
|||
del options["logging_level"] |
|||
|
|||
client = sentry_sdk.init(**options) |
|||
|
|||
sentry_sdk.set_tag("include_context", |
|||
config.get("sentry_include_context", True)) |
|||
|
|||
if exclude_loggers: |
|||
for item in exclude_loggers: |
|||
ignore_logger(item) |
|||
|
|||
wsgi_server.application = SentryWsgiMiddleware(wsgi_server.application) |
|||
|
|||
with sentry_sdk.push_scope() as scope: |
|||
scope.set_extra("debug", False) |
|||
sentry_sdk.capture_message("Starting Odoo Server", "info") |
|||
|
|||
return client |
|||
|
|||
|
|||
def post_load(): |
|||
initialize_sentry(odoo_config) |
@ -0,0 +1,137 @@ |
|||
""" Custom class of raven.core.processors taken of https://git.io/JITko |
|||
This is a custom class of processor to filter and sanitize |
|||
passwords and keys from request data, it does not exist in |
|||
sentry-sdk. |
|||
""" |
|||
|
|||
from __future__ import absolute_import |
|||
|
|||
import re |
|||
|
|||
from sentry_sdk._compat import text_type |
|||
from .generalutils import string_types, varmap |
|||
|
|||
|
|||
class SanitizeKeysProcessor(object): |
|||
""" Class from raven for sanitize keys, cookies, etc |
|||
Asterisk out things that correspond to a configurable set of keys. """ |
|||
|
|||
MASK = '*' * 8 |
|||
|
|||
def process(self, data, **kwargs): |
|||
if 'exception' in data: |
|||
if 'values' in data['exception']: |
|||
for value in data['exception'].get('values', []): |
|||
if 'stacktrace' in value: |
|||
self.filter_stacktrace(value['stacktrace']) |
|||
|
|||
if 'request' in data: |
|||
self.filter_http(data['request']) |
|||
|
|||
if 'extra' in data: |
|||
data['extra'] = self.filter_extra(data['extra']) |
|||
|
|||
if 'level' in data: |
|||
data['level'] = self.filter_level(data['level']) |
|||
|
|||
return data |
|||
|
|||
@property |
|||
def sanitize_keys(self): |
|||
pass |
|||
|
|||
def sanitize(self, item, value): |
|||
if value is None: |
|||
return |
|||
|
|||
if not item: # key can be a NoneType |
|||
return value |
|||
|
|||
# Just in case we have bytes here, we want to make them into text |
|||
# properly without failing so we can perform our check. |
|||
if isinstance(item, bytes): |
|||
item = item.decode('utf-8', 'replace') |
|||
else: |
|||
item = text_type(item) |
|||
|
|||
item = item.lower() |
|||
for key in self.sanitize_keys: |
|||
if key in item: |
|||
# store mask as a fixed length for security |
|||
return self.MASK |
|||
return value |
|||
|
|||
def filter_stacktrace(self, data): |
|||
for frame in data.get('frames', []): |
|||
if 'vars' not in frame: |
|||
continue |
|||
frame['vars'] = varmap(self.sanitize, frame['vars']) |
|||
|
|||
def filter_http(self, data): |
|||
for n in ('data', 'cookies', 'headers', 'env', 'query_string'): |
|||
if n not in data: |
|||
continue |
|||
|
|||
# data could be provided as bytes and if it's python3 |
|||
if isinstance(data[n], bytes): |
|||
data[n] = data[n].decode('utf-8', 'replace') |
|||
|
|||
if isinstance(data[n], string_types()) and '=' in data[n]: |
|||
# at this point we've assumed it's a standard HTTP query |
|||
# or cookie |
|||
if n == 'cookies': |
|||
delimiter = ';' |
|||
else: |
|||
delimiter = '&' |
|||
|
|||
data[n] = self._sanitize_keyvals(data[n], delimiter) |
|||
else: |
|||
data[n] = varmap(self.sanitize, data[n]) |
|||
if n == 'headers' and 'Cookie' in data[n]: |
|||
data[n]['Cookie'] = self._sanitize_keyvals( |
|||
data[n]['Cookie'], ';' |
|||
) |
|||
|
|||
def filter_extra(self, data): |
|||
return varmap(self.sanitize, data) |
|||
|
|||
def filter_level(self, data): |
|||
return re.sub(r'\x1b(\[.*?[@-~]|\].*?(\x07|\x1b\\))', '', data) |
|||
|
|||
def _sanitize_keyvals(self, keyvals, delimiter): |
|||
sanitized_keyvals = [] |
|||
for keyval in keyvals.split(delimiter): |
|||
keyval = keyval.split('=') |
|||
if len(keyval) == 2: |
|||
sanitized_keyvals.append((keyval[0], self.sanitize(*keyval))) |
|||
else: |
|||
sanitized_keyvals.append(keyval) |
|||
|
|||
return delimiter.join('='.join(keyval) for keyval in sanitized_keyvals) |
|||
|
|||
|
|||
class SanitizePasswordsProcessor(SanitizeKeysProcessor): |
|||
""" Asterisk out things that look like passwords, credit card numbers, |
|||
and API keys in frames, http, and basic extra data. """ |
|||
|
|||
KEYS = frozenset([ |
|||
'password', |
|||
'secret', |
|||
'passwd', |
|||
'authorization', |
|||
'api_key', |
|||
'apikey', |
|||
'sentry_dsn', |
|||
'access_token', |
|||
]) |
|||
VALUES_RE = re.compile(r'^(?:\d[ -]*?){13,16}$') |
|||
|
|||
@property |
|||
def sanitize_keys(self): |
|||
return self.KEYS |
|||
|
|||
def sanitize(self, item, value): |
|||
value = super(SanitizePasswordsProcessor, self).sanitize(item, value) |
|||
if isinstance(value, string_types()) and self.VALUES_RE.match(value): |
|||
return self.MASK |
|||
return value |
@ -0,0 +1,3 @@ |
|||
The following additional configuration options can be added to your Odoo |
|||
configuration file: |
|||
|
@ -0,0 +1,4 @@ |
|||
* Mohammed Barsi <barsintod@gmail.com> |
|||
* Andrius Preimantas <andrius@versada.eu> |
|||
* Naglis Jonaitis <naglis@versada.eu> |
|||
* Atte Isopuro <atte.isopuro@avoin.systems> |
@ -0,0 +1 @@ |
|||
* Vauxoo |
@ -0,0 +1,76 @@ |
|||
This module allows painless `Sentry <https://sentry.io/>`__ integration with |
|||
Odoo. |
|||
|
|||
============================= ==================================================================== ========================================================== |
|||
Option Description Default |
|||
============================= ==================================================================== ========================================================== |
|||
``sentry_dsn`` Sentry *Data Source Name*. You can find this value in your Sentry ``''`` |
|||
project configuration. Typically it looks something like this: |
|||
*https://<public_key>:<secret_key>@sentry.example.com/<project id>* |
|||
This is the only required option in order to use the module. |
|||
|
|||
``sentry_enabled`` Whether or not Sentry logging is enabled. ``False`` |
|||
|
|||
``sentry_logging_level`` The minimal logging level for which to send reports to Sentry. ``warn`` |
|||
Possible values: *notset*, *debug*, *info*, *warn*, *error*, |
|||
*critical*. It is recommended to have this set to at least *warn*, |
|||
to avoid spamming yourself with Sentry events. |
|||
|
|||
``sentry_exclude_loggers`` A string of comma-separated logger names which should be excluded ``werkzeug`` |
|||
from Sentry. |
|||
|
|||
``sentry_ignored_exceptions`` A string of comma-separated exceptions which should be ignored. ``odoo.exceptions.AccessDenied, |
|||
You can use a star symbol (*) at the end, to ignore all exceptions odoo.exceptions.AccessError, |
|||
from a module, eg.: *odoo.exceptions.**. odoo.exceptions.DeferredException, |
|||
odoo.exceptions.MissingError, |
|||
odoo.exceptions.RedirectWarning, |
|||
odoo.exceptions.UserError, |
|||
odoo.exceptions.ValidationError, |
|||
odoo.exceptions.Warning, |
|||
odoo.exceptions.except_orm`` |
|||
|
|||
``sentry_include_context`` If enabled, additional context data will be extracted from current ``True`` |
|||
HTTP request and user session (if available). This has no effect |
|||
for Cron jobs, as no request/session is available inside a Cron job. |
|||
|
|||
``sentry_release`` Explicitly define a version to be sent as the release version to |
|||
Sentry. Useful in conjuntion with Sentry's "Resolve in the next |
|||
release"-functionality. Also useful if your production deployment |
|||
does not include any Git context from which a commit might be read. |
|||
Overrides *sentry_odoo_dir*. |
|||
|
|||
``sentry_odoo_dir`` Absolute path to your Odoo installation directory. This is optional |
|||
and will only be used to extract the Odoo Git commit, which will be |
|||
sent to Sentry, to allow to distinguish between Odoo updates. |
|||
Overridden by *sentry_release* |
|||
============================= ==================================================================== ========================================================== |
|||
|
|||
Other `client arguments |
|||
<https://docs.sentry.io/platforms/python/configuration/>`_ can be |
|||
configured by prepending the argument name with *sentry_* in your Odoo config |
|||
file. Currently supported additional client arguments are: ``with_locals, |
|||
max_breadcrumbs, release, environment, server_name, shutdown_timeout, |
|||
in_app_include, in_app_exclude, default_integrations, dist, sample_rate, |
|||
send_default_pii, http_proxy, https_proxy, request_bodies, debug, |
|||
attach_stacktrace, ca_certs, propagate_traces, traces_sample_rate, |
|||
auto_enabling_integrations``. |
|||
|
|||
Example Odoo configuration |
|||
-------------------------- |
|||
|
|||
Below is an example of Odoo configuration file with *Odoo Sentry* options:: |
|||
|
|||
[options] |
|||
sentry_dsn = https://<public_key>:<secret_key>@sentry.example.com/<project id> |
|||
sentry_enabled = true |
|||
sentry_logging_level = warn |
|||
sentry_exclude_loggers = werkzeug |
|||
sentry_ignore_exceptions = odoo.exceptions.AccessDenied, |
|||
odoo.exceptions.AccessError,odoo.exceptions.MissingError, |
|||
odoo.exceptions.RedirectWarning,odoo.exceptions.UserError, |
|||
odoo.exceptions.ValidationError,odoo.exceptions.Warning, |
|||
odoo.exceptions.except_orm |
|||
sentry_include_context = true |
|||
sentry_environment = production |
|||
sentry_release = 1.3.2 |
|||
sentry_odoo_dir = /home/odoo/odoo/ |
@ -0,0 +1,10 @@ |
|||
The module can be installed just like any other Odoo module, by adding the |
|||
module's directory to Odoo *addons_path*. In order for the module to correctly |
|||
wrap the Odoo WSGI application, it also needs to be loaded as a server-wide |
|||
module. This can be done with the ``server_wide_modules`` parameter in your |
|||
Odoo config file or with the ``--load`` command-line parameter. |
|||
|
|||
This module additionally requires the sentry-sdk Python package to be available on |
|||
the system. It can be installed using pip:: |
|||
|
|||
pip install sentry-sdk |
@ -0,0 +1,11 @@ |
|||
* **No database separation** -- This module functions by intercepting all Odoo |
|||
logging records in a running Odoo process. This means that once installed in |
|||
one database, it will intercept and report errors for all Odoo databases, |
|||
which are used on that Odoo server. |
|||
|
|||
* **Frontend integration** -- In the future, it would be nice to add |
|||
Odoo client-side error reporting to this module as well, by integrating |
|||
`raven-js <https://github.com/getsentry/raven-js>`_. Additionally, `Sentry user |
|||
feedback form <https://docs.sentry.io/learn/user-feedback/>`_ could be |
|||
integrated into the Odoo client error dialog window to allow users shortly |
|||
describe what they were doing when things went wrong. |
@ -0,0 +1,6 @@ |
|||
Once configured and installed, the module will report any logging event at and |
|||
above the configured Sentry logging level, no additional actions are necessary. |
|||
|
|||
.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas |
|||
:alt: Try me on Runbot |
|||
:target: https://runbot.odoo-community.org/runbot/149/10.0 |
@ -0,0 +1,579 @@ |
|||
<?xml version="1.0" encoding="utf-8" ?> |
|||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
|||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
|||
<head> |
|||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
|||
<meta name="generator" content="Docutils 0.15.1: http://docutils.sourceforge.net/" /> |
|||
<title>Sentry</title> |
|||
<style type="text/css"> |
|||
|
|||
/* |
|||
:Author: David Goodger (goodger@python.org) |
|||
:Id: $Id: html4css1.css 7952 2016-07-26 18:15:59Z milde $ |
|||
:Copyright: This stylesheet has been placed in the public domain. |
|||
|
|||
Default cascading style sheet for the HTML output of Docutils. |
|||
|
|||
See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to |
|||
customize this style sheet. |
|||
*/ |
|||
|
|||
/* used to remove borders from tables and images */ |
|||
.borderless, table.borderless td, table.borderless th { |
|||
border: 0 } |
|||
|
|||
table.borderless td, table.borderless th { |
|||
/* Override padding for "table.docutils td" with "! important". |
|||
The right padding separates the table cells. */ |
|||
padding: 0 0.5em 0 0 ! important } |
|||
|
|||
.first { |
|||
/* Override more specific margin styles with "! important". */ |
|||
margin-top: 0 ! important } |
|||
|
|||
.last, .with-subtitle { |
|||
margin-bottom: 0 ! important } |
|||
|
|||
.hidden { |
|||
display: none } |
|||
|
|||
.subscript { |
|||
vertical-align: sub; |
|||
font-size: smaller } |
|||
|
|||
.superscript { |
|||
vertical-align: super; |
|||
font-size: smaller } |
|||
|
|||
a.toc-backref { |
|||
text-decoration: none ; |
|||
color: black } |
|||
|
|||
blockquote.epigraph { |
|||
margin: 2em 5em ; } |
|||
|
|||
dl.docutils dd { |
|||
margin-bottom: 0.5em } |
|||
|
|||
object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] { |
|||
overflow: hidden; |
|||
} |
|||
|
|||
/* Uncomment (and remove this text!) to get bold-faced definition list terms |
|||
dl.docutils dt { |
|||
font-weight: bold } |
|||
*/ |
|||
|
|||
div.abstract { |
|||
margin: 2em 5em } |
|||
|
|||
div.abstract p.topic-title { |
|||
font-weight: bold ; |
|||
text-align: center } |
|||
|
|||
div.admonition, div.attention, div.caution, div.danger, div.error, |
|||
div.hint, div.important, div.note, div.tip, div.warning { |
|||
margin: 2em ; |
|||
border: medium outset ; |
|||
padding: 1em } |
|||
|
|||
div.admonition p.admonition-title, div.hint p.admonition-title, |
|||
div.important p.admonition-title, div.note p.admonition-title, |
|||
div.tip p.admonition-title { |
|||
font-weight: bold ; |
|||
font-family: sans-serif } |
|||
|
|||
div.attention p.admonition-title, div.caution p.admonition-title, |
|||
div.danger p.admonition-title, div.error p.admonition-title, |
|||
div.warning p.admonition-title, .code .error { |
|||
color: red ; |
|||
font-weight: bold ; |
|||
font-family: sans-serif } |
|||
|
|||
/* Uncomment (and remove this text!) to get reduced vertical space in |
|||
compound paragraphs. |
|||
div.compound .compound-first, div.compound .compound-middle { |
|||
margin-bottom: 0.5em } |
|||
|
|||
div.compound .compound-last, div.compound .compound-middle { |
|||
margin-top: 0.5em } |
|||
*/ |
|||
|
|||
div.dedication { |
|||
margin: 2em 5em ; |
|||
text-align: center ; |
|||
font-style: italic } |
|||
|
|||
div.dedication p.topic-title { |
|||
font-weight: bold ; |
|||
font-style: normal } |
|||
|
|||
div.figure { |
|||
margin-left: 2em ; |
|||
margin-right: 2em } |
|||
|
|||
div.footer, div.header { |
|||
clear: both; |
|||
font-size: smaller } |
|||
|
|||
div.line-block { |
|||
display: block ; |
|||
margin-top: 1em ; |
|||
margin-bottom: 1em } |
|||
|
|||
div.line-block div.line-block { |
|||
margin-top: 0 ; |
|||
margin-bottom: 0 ; |
|||
margin-left: 1.5em } |
|||
|
|||
div.sidebar { |
|||
margin: 0 0 0.5em 1em ; |
|||
border: medium outset ; |
|||
padding: 1em ; |
|||
background-color: #ffffee ; |
|||
width: 40% ; |
|||
float: right ; |
|||
clear: right } |
|||
|
|||
div.sidebar p.rubric { |
|||
font-family: sans-serif ; |
|||
font-size: medium } |
|||
|
|||
div.system-messages { |
|||
margin: 5em } |
|||
|
|||
div.system-messages h1 { |
|||
color: red } |
|||
|
|||
div.system-message { |
|||
border: medium outset ; |
|||
padding: 1em } |
|||
|
|||
div.system-message p.system-message-title { |
|||
color: red ; |
|||
font-weight: bold } |
|||
|
|||
div.topic { |
|||
margin: 2em } |
|||
|
|||
h1.section-subtitle, h2.section-subtitle, h3.section-subtitle, |
|||
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle { |
|||
margin-top: 0.4em } |
|||
|
|||
h1.title { |
|||
text-align: center } |
|||
|
|||
h2.subtitle { |
|||
text-align: center } |
|||
|
|||
hr.docutils { |
|||
width: 75% } |
|||
|
|||
img.align-left, .figure.align-left, object.align-left, table.align-left { |
|||
clear: left ; |
|||
float: left ; |
|||
margin-right: 1em } |
|||
|
|||
img.align-right, .figure.align-right, object.align-right, table.align-right { |
|||
clear: right ; |
|||
float: right ; |
|||
margin-left: 1em } |
|||
|
|||
img.align-center, .figure.align-center, object.align-center { |
|||
display: block; |
|||
margin-left: auto; |
|||
margin-right: auto; |
|||
} |
|||
|
|||
table.align-center { |
|||
margin-left: auto; |
|||
margin-right: auto; |
|||
} |
|||
|
|||
.align-left { |
|||
text-align: left } |
|||
|
|||
.align-center { |
|||
clear: both ; |
|||
text-align: center } |
|||
|
|||
.align-right { |
|||
text-align: right } |
|||
|
|||
/* reset inner alignment in figures */ |
|||
div.align-right { |
|||
text-align: inherit } |
|||
|
|||
/* div.align-center * { */ |
|||
/* text-align: left } */ |
|||
|
|||
.align-top { |
|||
vertical-align: top } |
|||
|
|||
.align-middle { |
|||
vertical-align: middle } |
|||
|
|||
.align-bottom { |
|||
vertical-align: bottom } |
|||
|
|||
ol.simple, ul.simple { |
|||
margin-bottom: 1em } |
|||
|
|||
ol.arabic { |
|||
list-style: decimal } |
|||
|
|||
ol.loweralpha { |
|||
list-style: lower-alpha } |
|||
|
|||
ol.upperalpha { |
|||
list-style: upper-alpha } |
|||
|
|||
ol.lowerroman { |
|||
list-style: lower-roman } |
|||
|
|||
ol.upperroman { |
|||
list-style: upper-roman } |
|||
|
|||
p.attribution { |
|||
text-align: right ; |
|||
margin-left: 50% } |
|||
|
|||
p.caption { |
|||
font-style: italic } |
|||
|
|||
p.credits { |
|||
font-style: italic ; |
|||
font-size: smaller } |
|||
|
|||
p.label { |
|||
white-space: nowrap } |
|||
|
|||
p.rubric { |
|||
font-weight: bold ; |
|||
font-size: larger ; |
|||
color: maroon ; |
|||
text-align: center } |
|||
|
|||
p.sidebar-title { |
|||
font-family: sans-serif ; |
|||
font-weight: bold ; |
|||
font-size: larger } |
|||
|
|||
p.sidebar-subtitle { |
|||
font-family: sans-serif ; |
|||
font-weight: bold } |
|||
|
|||
p.topic-title { |
|||
font-weight: bold } |
|||
|
|||
pre.address { |
|||
margin-bottom: 0 ; |
|||
margin-top: 0 ; |
|||
font: inherit } |
|||
|
|||
pre.literal-block, pre.doctest-block, pre.math, pre.code { |
|||
margin-left: 2em ; |
|||
margin-right: 2em } |
|||
|
|||
pre.code .ln { color: grey; } /* line numbers */ |
|||
pre.code, code { background-color: #eeeeee } |
|||
pre.code .comment, code .comment { color: #5C6576 } |
|||
pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold } |
|||
pre.code .literal.string, code .literal.string { color: #0C5404 } |
|||
pre.code .name.builtin, code .name.builtin { color: #352B84 } |
|||
pre.code .deleted, code .deleted { background-color: #DEB0A1} |
|||
pre.code .inserted, code .inserted { background-color: #A3D289} |
|||
|
|||
span.classifier { |
|||
font-family: sans-serif ; |
|||
font-style: oblique } |
|||
|
|||
span.classifier-delimiter { |
|||
font-family: sans-serif ; |
|||
font-weight: bold } |
|||
|
|||
span.interpreted { |
|||
font-family: sans-serif } |
|||
|
|||
span.option { |
|||
white-space: nowrap } |
|||
|
|||
span.pre { |
|||
white-space: pre } |
|||
|
|||
span.problematic { |
|||
color: red } |
|||
|
|||
span.section-subtitle { |
|||
/* font-size relative to parent (h1..h6 element) */ |
|||
font-size: 80% } |
|||
|
|||
table.citation { |
|||
border-left: solid 1px gray; |
|||
margin-left: 1px } |
|||
|
|||
table.docinfo { |
|||
margin: 2em 4em } |
|||
|
|||
table.docutils { |
|||
margin-top: 0.5em ; |
|||
margin-bottom: 0.5em } |
|||
|
|||
table.footnote { |
|||
border-left: solid 1px black; |
|||
margin-left: 1px } |
|||
|
|||
table.docutils td, table.docutils th, |
|||
table.docinfo td, table.docinfo th { |
|||
padding-left: 0.5em ; |
|||
padding-right: 0.5em ; |
|||
vertical-align: top } |
|||
|
|||
table.docutils th.field-name, table.docinfo th.docinfo-name { |
|||
font-weight: bold ; |
|||
text-align: left ; |
|||
white-space: nowrap ; |
|||
padding-left: 0 } |
|||
|
|||
/* "booktabs" style (no vertical lines) */ |
|||
table.docutils.booktabs { |
|||
border: 0px; |
|||
border-top: 2px solid; |
|||
border-bottom: 2px solid; |
|||
border-collapse: collapse; |
|||
} |
|||
table.docutils.booktabs * { |
|||
border: 0px; |
|||
} |
|||
table.docutils.booktabs th { |
|||
border-bottom: thin solid; |
|||
text-align: left; |
|||
} |
|||
|
|||
h1 tt.docutils, h2 tt.docutils, h3 tt.docutils, |
|||
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils { |
|||
font-size: 100% } |
|||
|
|||
ul.auto-toc { |
|||
list-style-type: none } |
|||
|
|||
</style> |
|||
</head> |
|||
<body> |
|||
<div class="document" id="sentry"> |
|||
<h1 class="title">Sentry</h1> |
|||
|
|||
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
|||
!! This file is generated by oca-gen-addon-readme !! |
|||
!! changes will be overwritten. !! |
|||
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! --> |
|||
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/server-tools/tree/12.0-migsentrynewapi-fer/sentry"><img alt="OCA/server-tools" src="https://img.shields.io/badge/github-OCA%2Fserver--tools-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/server-tools-12-0-migsentrynewapi-fer/server-tools-12-0-migsentrynewapi-fer-sentry"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/149/12.0-migsentrynewapi-fer"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> |
|||
<p>This module allows painless <a class="reference external" href="https://sentry.io/">Sentry</a> integration with |
|||
Odoo.</p> |
|||
<table border="1" class="docutils"> |
|||
<colgroup> |
|||
<col width="19%" /> |
|||
<col width="44%" /> |
|||
<col width="37%" /> |
|||
</colgroup> |
|||
<thead valign="bottom"> |
|||
<tr><th class="head">Option</th> |
|||
<th class="head">Description</th> |
|||
<th class="head">Default</th> |
|||
</tr> |
|||
</thead> |
|||
<tbody valign="top"> |
|||
<tr><td><tt class="docutils literal">sentry_dsn</tt></td> |
|||
<td>Sentry <em>Data Source Name</em>. You can find this value in your Sentry |
|||
project configuration. Typically it looks something like this: |
|||
<em>https://<public_key>:<secret_key>@sentry.example.com/<project id></em> |
|||
This is the only required option in order to use the module.</td> |
|||
<td><tt class="docutils literal">''</tt></td> |
|||
</tr> |
|||
<tr><td><tt class="docutils literal">sentry_enabled</tt></td> |
|||
<td>Whether or not Sentry logging is enabled.</td> |
|||
<td><tt class="docutils literal">False</tt></td> |
|||
</tr> |
|||
<tr><td><tt class="docutils literal">sentry_logging_level</tt></td> |
|||
<td>The minimal logging level for which to send reports to Sentry. |
|||
Possible values: <em>notset</em>, <em>debug</em>, <em>info</em>, <em>warn</em>, <em>error</em>, |
|||
<em>critical</em>. It is recommended to have this set to at least <em>warn</em>, |
|||
to avoid spamming yourself with Sentry events.</td> |
|||
<td><tt class="docutils literal">warn</tt></td> |
|||
</tr> |
|||
<tr><td><tt class="docutils literal">sentry_exclude_loggers</tt></td> |
|||
<td>A string of comma-separated logger names which should be excluded |
|||
from Sentry.</td> |
|||
<td><tt class="docutils literal">werkzeug</tt></td> |
|||
</tr> |
|||
<tr><td><tt class="docutils literal">sentry_ignored_exceptions</tt></td> |
|||
<td>A string of comma-separated exceptions which should be ignored. |
|||
You can use a star symbol (*) at the end, to ignore all exceptions |
|||
from a module, eg.: <em>odoo.exceptions.*</em>.</td> |
|||
<td><tt class="docutils literal">odoo.exceptions.AccessDenied, |
|||
odoo.exceptions.AccessError, |
|||
odoo.exceptions.DeferredException, |
|||
odoo.exceptions.MissingError, |
|||
odoo.exceptions.RedirectWarning, |
|||
odoo.exceptions.UserError, |
|||
odoo.exceptions.ValidationError, |
|||
odoo.exceptions.Warning, |
|||
odoo.exceptions.except_orm</tt></td> |
|||
</tr> |
|||
<tr><td><tt class="docutils literal">sentry_include_context</tt></td> |
|||
<td>If enabled, additional context data will be extracted from current |
|||
HTTP request and user session (if available). This has no effect |
|||
for Cron jobs, as no request/session is available inside a Cron job.</td> |
|||
<td><tt class="docutils literal">True</tt></td> |
|||
</tr> |
|||
<tr><td><tt class="docutils literal">sentry_release</tt></td> |
|||
<td>Explicitly define a version to be sent as the release version to |
|||
Sentry. Useful in conjuntion with Sentry’s “Resolve in the next |
|||
release”-functionality. Also useful if your production deployment |
|||
does not include any Git context from which a commit might be read. |
|||
Overrides <em>sentry_odoo_dir</em>.</td> |
|||
<td> </td> |
|||
</tr> |
|||
<tr><td><tt class="docutils literal">sentry_odoo_dir</tt></td> |
|||
<td>Absolute path to your Odoo installation directory. This is optional |
|||
and will only be used to extract the Odoo Git commit, which will be |
|||
sent to Sentry, to allow to distinguish between Odoo updates. |
|||
Overridden by <em>sentry_release</em></td> |
|||
<td> </td> |
|||
</tr> |
|||
</tbody> |
|||
</table> |
|||
<p>Other <a class="reference external" href="https://docs.sentry.io/platforms/python/configuration/">client arguments</a> can be |
|||
configured by prepending the argument name with <em>sentry_</em> in your Odoo config |
|||
file. Currently supported additional client arguments are: <tt class="docutils literal">with_locals, |
|||
max_breadcrumbs, release, environment, server_name, shutdown_timeout, |
|||
in_app_include, in_app_exclude, default_integrations, dist, sample_rate, |
|||
send_default_pii, http_proxy, https_proxy, request_bodies, debug, |
|||
attach_stacktrace, ca_certs, propagate_traces, traces_sample_rate, |
|||
auto_enabling_integrations</tt>.</p> |
|||
<div class="section" id="example-odoo-configuration"> |
|||
<h1>Example Odoo configuration</h1> |
|||
<p>Below is an example of Odoo configuration file with <em>Odoo Sentry</em> options:</p> |
|||
<pre class="literal-block"> |
|||
[options] |
|||
sentry_dsn = https://<public_key>:<secret_key>@sentry.example.com/<project id> |
|||
sentry_enabled = true |
|||
sentry_logging_level = warn |
|||
sentry_exclude_loggers = werkzeug |
|||
sentry_ignore_exceptions = odoo.exceptions.AccessDenied, |
|||
odoo.exceptions.AccessError,odoo.exceptions.MissingError, |
|||
odoo.exceptions.RedirectWarning,odoo.exceptions.UserError, |
|||
odoo.exceptions.ValidationError,odoo.exceptions.Warning, |
|||
odoo.exceptions.except_orm |
|||
sentry_include_context = true |
|||
sentry_environment = production |
|||
sentry_release = 1.3.2 |
|||
sentry_odoo_dir = /home/odoo/odoo/ |
|||
</pre> |
|||
<p><strong>Table of contents</strong></p> |
|||
<div class="contents local topic" id="contents"> |
|||
<ul class="simple"> |
|||
<li><a class="reference internal" href="#installation" id="id1">Installation</a></li> |
|||
<li><a class="reference internal" href="#configuration" id="id2">Configuration</a></li> |
|||
<li><a class="reference internal" href="#usage" id="id3">Usage</a></li> |
|||
<li><a class="reference internal" href="#known-issues-roadmap" id="id4">Known issues / Roadmap</a></li> |
|||
<li><a class="reference internal" href="#bug-tracker" id="id5">Bug Tracker</a></li> |
|||
<li><a class="reference internal" href="#credits" id="id6">Credits</a><ul> |
|||
<li><a class="reference internal" href="#authors" id="id7">Authors</a></li> |
|||
<li><a class="reference internal" href="#contributors" id="id8">Contributors</a></li> |
|||
<li><a class="reference internal" href="#other-credits" id="id9">Other credits</a></li> |
|||
<li><a class="reference internal" href="#maintainers" id="id10">Maintainers</a></li> |
|||
</ul> |
|||
</li> |
|||
</ul> |
|||
</div> |
|||
<div class="section" id="installation"> |
|||
<h2><a class="toc-backref" href="#id1">Installation</a></h2> |
|||
<p>The module can be installed just like any other Odoo module, by adding the |
|||
module’s directory to Odoo <em>addons_path</em>. In order for the module to correctly |
|||
wrap the Odoo WSGI application, it also needs to be loaded as a server-wide |
|||
module. This can be done with the <tt class="docutils literal">server_wide_modules</tt> parameter in your |
|||
Odoo config file or with the <tt class="docutils literal"><span class="pre">--load</span></tt> command-line parameter.</p> |
|||
<p>This module additionally requires the sentry-sdk Python package to be available on |
|||
the system. It can be installed using pip:</p> |
|||
<pre class="literal-block"> |
|||
pip install sentry-sdk |
|||
</pre> |
|||
</div> |
|||
<div class="section" id="configuration"> |
|||
<h2><a class="toc-backref" href="#id2">Configuration</a></h2> |
|||
<p>The following additional configuration options can be added to your Odoo |
|||
configuration file:</p> |
|||
</div> |
|||
<div class="section" id="usage"> |
|||
<h2><a class="toc-backref" href="#id3">Usage</a></h2> |
|||
<p>Once configured and installed, the module will report any logging event at and |
|||
above the configured Sentry logging level, no additional actions are necessary.</p> |
|||
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/149/10.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a> |
|||
</div> |
|||
<div class="section" id="known-issues-roadmap"> |
|||
<h2><a class="toc-backref" href="#id4">Known issues / Roadmap</a></h2> |
|||
<ul class="simple"> |
|||
<li><strong>No database separation</strong> – This module functions by intercepting all Odoo |
|||
logging records in a running Odoo process. This means that once installed in |
|||
one database, it will intercept and report errors for all Odoo databases, |
|||
which are used on that Odoo server.</li> |
|||
<li><strong>Frontend integration</strong> – In the future, it would be nice to add |
|||
Odoo client-side error reporting to this module as well, by integrating |
|||
<a class="reference external" href="https://github.com/getsentry/raven-js">raven-js</a>. Additionally, <a class="reference external" href="https://docs.sentry.io/learn/user-feedback/">Sentry user |
|||
feedback form</a> could be |
|||
integrated into the Odoo client error dialog window to allow users shortly |
|||
describe what they were doing when things went wrong.</li> |
|||
</ul> |
|||
</div> |
|||
<div class="section" id="bug-tracker"> |
|||
<h2><a class="toc-backref" href="#id5">Bug Tracker</a></h2> |
|||
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/server-tools/issues">GitHub Issues</a>. |
|||
In case of trouble, please check there if your issue has already been reported. |
|||
If you spotted it first, help us smashing it by providing a detailed and welcomed |
|||
<a class="reference external" href="https://github.com/OCA/server-tools/issues/new?body=module:%20sentry%0Aversion:%2012.0-migsentrynewapi-fer%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> |
|||
<p>Do not contact contributors directly about support or help with technical issues.</p> |
|||
</div> |
|||
<div class="section" id="credits"> |
|||
<h2><a class="toc-backref" href="#id6">Credits</a></h2> |
|||
<div class="section" id="authors"> |
|||
<h3><a class="toc-backref" href="#id7">Authors</a></h3> |
|||
<ul class="simple"> |
|||
<li>Mohammed Barsi</li> |
|||
<li>Versada</li> |
|||
<li>Nicolas JEUDY</li> |
|||
<li>Vauxoo</li> |
|||
</ul> |
|||
</div> |
|||
<div class="section" id="contributors"> |
|||
<h3><a class="toc-backref" href="#id8">Contributors</a></h3> |
|||
<ul class="simple"> |
|||
<li>Mohammed Barsi <<a class="reference external" href="mailto:barsintod@gmail.com">barsintod@gmail.com</a>></li> |
|||
<li>Andrius Preimantas <<a class="reference external" href="mailto:andrius@versada.eu">andrius@versada.eu</a>></li> |
|||
<li>Naglis Jonaitis <<a class="reference external" href="mailto:naglis@versada.eu">naglis@versada.eu</a>></li> |
|||
<li>Atte Isopuro <<a class="reference external" href="mailto:atte.isopuro@avoin.systems">atte.isopuro@avoin.systems</a>></li> |
|||
</ul> |
|||
</div> |
|||
<div class="section" id="other-credits"> |
|||
<h3><a class="toc-backref" href="#id9">Other credits</a></h3> |
|||
<ul class="simple"> |
|||
<li>Vauxoo</li> |
|||
</ul> |
|||
</div> |
|||
<div class="section" id="maintainers"> |
|||
<h3><a class="toc-backref" href="#id10">Maintainers</a></h3> |
|||
<p>This module is maintained by the OCA.</p> |
|||
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> |
|||
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose |
|||
mission is to support the collaborative development of Odoo features and |
|||
promote its widespread use.</p> |
|||
<p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainers</a>:</p> |
|||
<p><a class="reference external" href="https://github.com/barsi"><img alt="barsi" src="https://github.com/barsi.png?size=40px" /></a> <a class="reference external" href="https://github.com/naglis"><img alt="naglis" src="https://github.com/naglis.png?size=40px" /></a> <a class="reference external" href="https://github.com/versada"><img alt="versada" src="https://github.com/versada.png?size=40px" /></a> <a class="reference external" href="https://github.com/moylop260"><img alt="moylop260" src="https://github.com/moylop260.png?size=40px" /></a> <a class="reference external" href="https://github.com/fernandahf"><img alt="fernandahf" src="https://github.com/fernandahf.png?size=40px" /></a></p> |
|||
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/server-tools/tree/12.0-migsentrynewapi-fer/sentry">OCA/server-tools</a> project on GitHub.</p> |
|||
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p> |
|||
</div> |
|||
</div> |
|||
</div> |
|||
</div> |
|||
</body> |
|||
</html> |
Write
Preview
Loading…
Cancel
Save
Reference in new issue