Metadata-Version: 2.1
Name: f5-teem
Version: 1.0.2
Summary: F5 TEEM Library
Home-page: UNKNOWN
Author: F5 Ecosystems Group
Author-email: solutionsfeedback@f5.com
License: Apache License 2.0
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2)

# Introduction

Python library providing an interface for F5's TEEM infrastructure to provide usage analytics to F5.

# Usage (Anonymous API)

```python
from f5teem import AnonymousDeviceClient

client_info = {
    'name': 'f5-example-product',
    'version': '1.0.0',
    'id': '<asset UUID>'
}
telemetry_client = AnonymousDeviceClient(client_info, api_key='<API KEY>')
telemetry_client.report(
    {
        'foo': 'bar'
    },
    telemetry_type='Installation Usage',
    telemetry_type_version='1'
)
```

By default, this library will include in the report telemetry client properties including:

- The type of Operating System where telemetry is sent from (for example, 'Linux')

## Example Telemetry Record

```json
{
    "digitalAssetName": "f5-example-product",
    "digitalAssetVersion": "1.0.0",
    "digitalAssetId": "<asset UUID>",
    "documentType": "Installation Usage",
    "documentVersion": "1",
    "observationStartTime": "",
    "observationEndTime": "",
    "epochTime": "",
    "telemetryId": "",
    "telemetryRecords": [
        {
            "foo": "bar",
            "telemetryClientProperties": {
                "os": "linux"
            }
        }
    ]
}
```

# Use TEEM staging environment

- Set environment variable
    ```bash
    export TEEM_API_ENVIRONMENT='staging'
    ```

# Additional Notes

- This library is similar to the node-based f5-teem library (https://www.npmjs.com/package/@f5devcentral/f5-teem).

## Future Improvements

- f5-teem-python should support Reg Key API when running on BIG-IP (similar to node based f5-teem library)
- f5-teem-python should honor the phone home setting when running on BIG-IP. `tmsh modify sys software update auto-phonehome disabled`


