Skip to main content

The package includes an object that you can use as a client for the locust.io load testing tool. The client can be used to write load testing workloads that automatically connect to a Vertica database.

The client also integrates with a graphite backend to be able to flow metrics to it.

Installation

To install this package:

pip install vertica_locust_client

Locust Command Line Parameters

This will automatically add parameters to locust that will control how to connect to Vertica and the graphite backend. These parameters are also exposed in the webUI.

--user              ID of user to connect to Vertica with (defaults to dbadmin)
--password          Password of the Vertica user ID (defaults to empty string)
--carbon-endpoint   The carbon endpoint to connect to.
                    The endpoint is defined as: host[:port][,host[:port]...]
--carbon-namespace  The namespace for the carbon metric.  This is treated as
                    the prefix when constructing the full metric name.

Sample locustfile

Here is a sample locustfile.py to show the client in action. This will issue a simple query to count the number of sessions in the database.

from locust import task
from vertica_locust_client import VerticaUser

class SessionCounterUser(VerticaUser):
    def __init__(self, environment):
        super().__init__(environment)

    @task
    def query_users(self):
        with self.client.make_cursor(carbon_metric="query") as cur:
            cur.execute('''
                select count(session_id) sessions
                from v_monitor.sessions
                where session_id not in (
                    select session_id
                    from current_session
                )
                ''')

Metadata

Release files for vertica-locust-client 0.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vertica-locust-client 0.0.6
File Size Uploaded Provenance
vertica_locust_client-0.0.6.tar.gz 3.7 kB Without provenance Details

Release files / vertica_locust_client-0.0.6.tar.gz

Download URL vertica_locust_client-0.0.6.tar.gz
Size 3.7 kB
Tags Source
SHA-256 checksum
How to use checksums
1173da255c2a3cbc1a2e90b33b9ef7f20a1f185fb27d917cefe8414b33f4cc5c
BLAKE2b-256 checksum
How to use checksums
7acb2bfa19e14ee8d36b15ace95085ea926d4657ccdd97341e170f55e308e0b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.10

Security for vertica-locust-client 0.0.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page