Automated check

c2cgeoportal applications include functionality for testing and assessing that the application is correctly functioning, i.e. that its web services respond as expected.

For this purpose we have a checker and a check_collector. These (especially the collector) are meant to be used by a monitoring system like Nagios to check that the application is alive.

They integrate into c2cwsgiutils’s health check service. The return codes are:

  • 200 => OK
  • 500 => Error

Note

Check collector can only check pages that are on the same server as itself.

You can access the health_check service with this kind of url:

<project_url>/c2c/health_check?max_level=3

The levels used in the default configuration (recommended settings):

  • 1: Vital checkers (quick checks).
  • 3: Slow service checks, like print and GetCapabilities.
  • 10: collector of different sites.

See also: https://github.com/camptocamp/c2cwsgiutils/#health-checks

The recommended URL that should be checked by services such as Pingdom:

<project_url>/c2c/health_check?checks=check_collector

The recommended URL to use to validate a migration (checker_url in proect.yaml.mako):

<project_url>/c2c/health_check?max_level=9

Note

For non Docker project the <project_url> should end with /wsgi.

Checker

The checker uses the following configuration structure in vars.yaml:

vars:
    # Global configuration
    ...
    checker:
        # Checker configurations

Note

If some of the checked services require an authenticated user, the forward_headers allows to forward Cookie or Authorisation headers in the underlying requests.

checker:
    forward_headers: ['Cookie', 'Authorisation']

Note

The checker assumes that it can access the c2cgeoportal services via http://localhost. If this is not allowed on your server, you can override this behaviour as follows. In your vars file, add the following:

vars:
    checker:
        rewrite_as_http_localhost: False

Now, in your configuration file project.yaml.mako, instead of defining the checker_path, define a checker_url with the full URL to be used, for example:

...
host: ${host}
checker_url: https://${host}/${instanceid}/wsgi/check_collector?
...

print

Check the print version 3.x (try to print a page).

Uses as spec the spec from configuration.

fulltextsearch

Check that the FullText-search service return an element.

Uses the search from configuration as text to search.

themes

Check that the theme has no error for all interfaces present in the database.

Uses the themes configuration:

themes:
    params:
        # Dictionary that represents the query string
    <interface>:
        params:
            # Dictionary that represents the query string
    level: 2

lang

Check that all the language files are present.

Uses the global configuration available_locale_names, and the checker configuration files, an array of stringis that must be in [cgxp, cgxp-api, ngeo].

routes

Check some routes, configured in routes as array of objects with:

* ``name`` the route name.
* ``display_name`` the name to be displayed.
* ``params`` the used query string as a dictionary.
* ``level``

In the configuration, we can also fill the routes_disable to disable some routes.

phantomjs

Check with phantomjs that the pages load correctly without errors, using the routes configuration as an array of route names to check:

* ``name`` the route name.
* ``params`` the used query string as a dictionary.
* ``level``

Infrastructure

If you experience connection issues with your checker, the following configuration options may be useful for you:

vars:
  checker:
    [base_internal_url]: URL like http://localhost:8080
    [forward_host]: <True|False>

Check collector

Used to collect checks from a different instance in the parent/children structure. It is useful to perform a set of checks all at once.

The check collector uses the following configuration structure:

vars:
    # Global configuration
    ...
    check_collector:
        max_level: 1
        level: 2
        hosts: []

The max_level is the default max_level parameter used for every host. The max_level option can be set for a host to override it.

To add a host:

vars:
    check_collector:
        hosts:
        - display: Child
          url: http://{host}/child/wsgi
          max_level: 1

update_paths:
- check_collector.hosts