<h1 id="heading-firestore-grafana-datasource">firestore-grafana-datasource</h1>
<p><a target="_blank" href="https://cloud.google.com/firestore">Google Firestore</a> Data Source Plugin for <a target="_blank" href="https://grafana.com/">Grafana</a>.</p>
<p>Grafana Firestore Data Source Plugin enables integrating data on Firestore on to Grafana dashboards.</p>
<p>It uses <a target="_blank" href="https://github.com/pgollangi/FireQL">FireQL</a> to capture user query that translated to issue queries on Firestore and construct results.</p>
<blockquote>
<p><a target="_blank" href="https://github.com/pgollangi/FireQL">FireQL</a> is a Go library to query Google Firestore database using SQL syntax.</p>
</blockquote>
<div class="embed-wrapper"><div class="embed-loading"><div class="loadingRow"></div><div class="loadingRow"></div></div><a class="embed-card" href="https://github.com/pgollangi/firestore-grafana-datasource">https://github.com/pgollangi/firestore-grafana-datasource</a></div>
<p> </p>
<h2 id="heading-features">Features</h2>
<ul>
<li><p>Use Google Firestore as a data source for Grafana dashboards</p>
</li>
<li><p>Configure Firestore data source with GCP <code>Project Id</code> and <a target="_blank" href="https://cloud.google.com/firestore/docs/security/iam"><code>Service Account</code></a> for authentication</p>
</li>
<li><p>Store <code>Service Account</code> data source configuration in Grafana encrypted storage <a target="_blank" href="https://grafana.com/docs/grafana/latest/developers/plugins/create-a-grafana-plugin/extend-a-plugin/add-authentication-for-data-source-plugins/#encrypt-data-source-configuration">Secure JSON Data</a></p>
</li>
<li><p>Query Firestore <a target="_blank" href="https://firebase.google.com/docs/firestore/data-model#collections">collections</a> and path to collections</p>
</li>
<li><p>Auto detect data types: <code>string</code>, <code>number</code>, <code>boolean</code>, <code>json</code>, <code>time.Time</code></p>
</li>
<li><p>Query selected fields from the collection</p>
</li>
<li><p>Order query results</p>
</li>
<li><p>Limit query results</p>
</li>
<li><p>Query <a target="_blank" href="https://firebase.blog/posts/2019/06/understanding-collection-group-queries">Collection Groups</a></p>
</li>
</ul>
<h3 id="heading-firestore-data-source-configuration">Firestore data source configuration</h3>
<p><img src="https://github.com/pgollangi/firestore-grafana-datasource/raw/main/src/screenshots/firestore-datasource-configuration.png" alt class="image--center mx-auto" /></p>
<h3 id="heading-using-datasource">Using datasource</h3>
<p><img src="https://github.com/pgollangi/firestore-grafana-datasource/raw/main/src/screenshots/query-with-firestore-datasource.png" alt class="image--center mx-auto" /></p>


# firestore-grafana-datasource

[Google Firestore](https://cloud.google.com/firestore) Data Source Plugin for [Grafana](https://grafana.com/).

Grafana Firestore Data Source Plugin enables integrating data on Firestore on to Grafana dashboards.

It uses [FireQL](https://github.com/pgollangi/FireQL) to capture user query that translated to issue queries on Firestore and construct results.

> [FireQL](https://github.com/pgollangi/FireQL) is a Go library to query Google Firestore database using SQL syntax.

%[https://github.com/pgollangi/firestore-grafana-datasource] 

## Features

* Use Google Firestore as a data source for Grafana dashboards
    
* Configure Firestore data source with GCP `Project Id` and [`Service Account`](https://cloud.google.com/firestore/docs/security/iam) for authentication
    
* Store `Service Account` data source configuration in Grafana encrypted storage [Secure JSON Data](https://grafana.com/docs/grafana/latest/developers/plugins/create-a-grafana-plugin/extend-a-plugin/add-authentication-for-data-source-plugins/#encrypt-data-source-configuration)
    
* Query Firestore [collections](https://firebase.google.com/docs/firestore/data-model#collections) and path to collections
    
* Auto detect data types: `string`, `number`, `boolean`, `json`, `time.Time`
    
* Query selected fields from the collection
    
* Order query results
    
* Limit query results
    
* Query [Collection Groups](https://firebase.blog/posts/2019/06/understanding-collection-group-queries)
    

### Firestore data source configuration

![](https://github.com/pgollangi/firestore-grafana-datasource/raw/main/src/screenshots/firestore-datasource-configuration.png align="center")

### Using datasource

![](https://github.com/pgollangi/firestore-grafana-datasource/raw/main/src/screenshots/query-with-firestore-datasource.png align="center")

Grafana Firestore Data Source Plugin enables integrating data on Firestore on to Grafana dashboards.
It uses FireQL to capture user query that translated to

Google Firestore Data Source plugin for Grafana

I’m Prasanna Kumar Gollangi, experienced software engineer, a full stack developer, code quality oriented, thrilled about AI and other computer science technologies.


p.k.'s echo

p.k.'s echo

Google Firestore Data Source plugin for Grafana

firestore-grafana-datasource

Features

Firestore data source configuration

Using datasource