Metadata-Version: 2.1
Name: CloudWatchLogs2Pandas
Version: 0.0.2
Summary: Library to query CloudWatch Logs and create Pandas DataFrame from the results
Home-page: https://github.com/guyernest/CloudWatchLogs2Pandas
Author: Guy Ernest
Author-email: guy.ernest@gmail.com
License: Apache Software License 2.0
Description: CloudWatchLogs2Pandas
        ================
        
        <!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
        
        This file will become your README and also the index of your
        documentation.
        
        ## Install
        
        ``` sh
        pip install CloudWatchLogs2Pandas
        ```
        
        ## How to use
        
        You need to build your query based on the documentations
        [here](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html):
        
        ``` python
        query = 'fields @timestamp, @message | sort @timestamp desc | limit 5'
        log_group = '/aws/apigateway/welcome'
        ```
        
        ``` python
        cwq = CloudWatchQuery(query, log_group)
        ```
        
        When executing the query against the log group, the default time range
        of of 14 days.
        
        ``` python
        cwq.get_df()
        ```
        
        <div>
        <style scoped>
            .dataframe tbody tr th:only-of-type {
                vertical-align: middle;
            }
        
            .dataframe tbody tr th {
                vertical-align: top;
            }
        
            .dataframe thead th {
                text-align: right;
            }
        </style>
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
            </tr>
          </thead>
          <tbody>
          </tbody>
        </table>
        </div>
        
        In case you have no results, you can modify the time range. For example
        for `Last Year` you can use:
        
        ``` python
        cwq.get_df(days_start=365)
        ```
        
        <div>
        <style scoped>
            .dataframe tbody tr th:only-of-type {
                vertical-align: middle;
            }
        
            .dataframe tbody tr th {
                vertical-align: top;
            }
        
            .dataframe thead th {
                text-align: right;
            }
        </style>
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
              <th>timestamp</th>
              <th>message</th>
              <th>ptr</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <th>0</th>
              <td>2021-12-20 11:03:13.568</td>
              <td>Cloudwatch logs enabled for API Gateway</td>
              <td>CmAKKAokMzI3MTYzODM3MDU1Oi9hd3MvYXBpZ2F0ZXdheS...</td>
            </tr>
            <tr>
              <th>1</th>
              <td>2021-11-24 15:10:19.572</td>
              <td>Cloudwatch logs enabled for API Gateway</td>
              <td>CmAKKAokMzI3MTYzODM3MDU1Oi9hd3MvYXBpZ2F0ZXdheS...</td>
            </tr>
            <tr>
              <th>2</th>
              <td>2021-11-01 15:57:57.790</td>
              <td>Cloudwatch logs enabled for API Gateway</td>
              <td>CmAKKAokMzI3MTYzODM3MDU1Oi9hd3MvYXBpZ2F0ZXdheS...</td>
            </tr>
            <tr>
              <th>3</th>
              <td>2021-11-01 15:37:36.574</td>
              <td>Cloudwatch logs enabled for API Gateway</td>
              <td>CmAKKAokMzI3MTYzODM3MDU1Oi9hd3MvYXBpZ2F0ZXdheS...</td>
            </tr>
            <tr>
              <th>4</th>
              <td>2021-10-30 23:10:28.807</td>
              <td>Cloudwatch logs enabled for API Gateway</td>
              <td>CmAKKAokMzI3MTYzODM3MDU1Oi9hd3MvYXBpZ2F0ZXdheS...</td>
            </tr>
          </tbody>
        </table>
        </div>
        
        ### Additional configurations
        
        You can set the [AWS
        region](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html)
        with:
        
        ``` python
        cwq.set_region("us-west-2")
        ```
        
        More complicated time range:
        
        ``` python
        cwq.get_df(days_start=2, hours_start=4, hours_end=4)
        ```
        
        <div>
        <style scoped>
            .dataframe tbody tr th:only-of-type {
                vertical-align: middle;
            }
        
            .dataframe tbody tr th {
                vertical-align: top;
            }
        
            .dataframe thead th {
                text-align: right;
            }
        </style>
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
            </tr>
          </thead>
          <tbody>
          </tbody>
        </table>
        </div>
        
Keywords: nbdev jupyter notebook python
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: dev
